Microsoft Game Development Kit (GDK) 版本資訊

​

2026 年 4 月 Microsoft Game Development Kit (GDK) 版本資訊

​

簡介

​

GDKX

• 2026 年 4 月 GDKX 可以與 2019 年 11 月及更新版本的 GDKX 並存安裝。
• 您可以從 https://aka.ms/gdkdl 下載 GDKX 版本。
• 所有 GDKX 版本的版本資訊都位於 https://aka.ms/gdkreleasenotes。

​

GDK

• 您可以在 https://aka.ms/gdk-winget 下載 GDK 版本並檢視其版本資訊。

​

關於本文件

• 新功能
• 版本資訊：
  • 2026 年 4 月 GDK Update 5
  • 2026 年 4 月 GDK Update 4
  • 2026 年 4 月 GDK Update 3
  • 2026 年 4 月 GDK Update 2
  • 2026 年 4 月 GDK Update 1
  • 2026 年 4 月 GDK
• 已知問題
• 文件

注意：版本資訊的描述後面會附上一個編號，例如 [12345678]。對 GDKX 使用者而言，此編號代表 Microsoft 用來追蹤該項目相關工作與歷程記錄的內部識別碼。如果您對特定版本資訊有疑問，此編號可能對您的開發人員客戶經理有所幫助。

​

2026 年 4 月 Microsoft Game Development Kit 的新功能

• GDKX 和 GDK 的發行分為兩種類型：主要版本 (著重於功能，每年兩次) 和更新 (著重於修正，視合作夥伴需求隨時發行)。
• 若要檢視完整的新功能章節，請參閱線上版的新功能。
• 若要檢視舊版的版本資訊，GDKX 請參閱 GDK 論壇上的版本資訊文章。GDKX 和 GDK 可以在線上文件的 GDK 版本資訊中檢視版本資訊。

​

2026 年 4 月 GDK Update 5

​

問題修正

​

PlayFab Party

已將 PlayFab Party 更新至 v1.10.26，其中包含下列修正：

• 修正終結 PartyEndpoint 時可能發生的當機。
• 修正對 /MultiplayerServer/GetCognitiveServicesToken 傳回的空白、格式錯誤或不完整回應的處理方式。Party 現在會將要求回報為失敗，而不會發生可能的當機。
• 修正遠端裝置離開對等網路之後才完成直接連線設定時可能發生的當機。

[63883777]

​

系統

修正將大型字串傳遞至 XSpeechSynthesizerCreateStreamFromText 時，xgameruntime.dll!OnRuntimeDisconnected 中可能發生的遊戲當機。[63860960]

改善執行遊戲存檔讀取或寫入作業時的記憶體壓力處理。[63996543]

改善遊戲存檔讀取或寫入作業失敗時傳回的錯誤碼。[63996543]

​

2026 年 4 月 GDK Update 4

​

問題修正

​

Social Manager

修正 GDK C Thunks DLL 未匯出 Privacy 靜音清單、封鎖清單和 Social 好友要求計數變更處理常式函式的問題。這導致呼叫這些函式的遊戲在未提示的情況下連結到 XSAPI 靜態程式庫，而不是 thunks DLL，最後產生不相符的執行階段。[63776691]

修正填入 Social Manager 社交圖形時發生的堆疊溢位當機。原因是 PeoplehubService::DeserializeUser 使用了 17 KB 的堆疊框架，其中保存每個 XblSocialManagerUser 的三份多餘複本。[63776693]

​

MSIXVC1 (封裝)

不使用 /msixvc2 選項的 makepkg2 pack 再次可以正常運作，不會出現有關 /usepublisherkey 選項的錯誤。此問題是在 Update 3 中引入的。[63529609]

​

Wdapp

修正對同時具有 ARM64 和 x64 二進位檔的遊戲使用 wdapp register 時，在 ARM64 電腦上未選擇適當二進位檔的問題。[63756866]

​

PIX

修正 PIX 時間軸中未顯示具名柵欄箭號的問題。[63446892]

​

2026 年 4 月 GDK Update 3

​

通知

​

Publisher Content

電腦和主機遊戲現在可以隨附 Publisher Content。這是一種新的套件類型，可讓遊戲發行者在自己的 CDN 上裝載和更新內容，同時由平台繼續管理安裝、背景下載、完整性和使用者體驗。 開發人員可在 MicrosoftGame.config 中宣告 (透過基礎遊戲上新的 PublisherContent 元素，以及內容套件上的 PublisherContentBaseProduct 欄位)，並使用對應的新 makepkg 參數產生套件。 遊戲可以使用新的 XPackageGetPackageKind() API 識別現有 GDK API 傳回的套件種類，該 API 現在除了 Game 和 Content 之外，也會回報 XPackageKind::PublisherContent。 [63082917]

​

PlayFab Party

已將用於建置程式庫的 Windows 平台工具組從 v142 升級至 v143。[63294760]

​

PIX

提供新的 CLI 工具 convertpevt.exe，可轉換程式設計方式的計時擷取。[62666766]

​

問題修正

​

Clang/LLVM

XBOX Game OS 整合程式庫 xgameplatform.lib 已更新，新增下列 Win32 API 以支援 clang/LLVM 的 PGO 檢測實作：FlushViewOfFile、VirtualUnlock。 使用 clang/LLVM PGO 的開發人員，也需要為 clang/LLVM 實作所使用的部分舊版 POSIX API 提供連結別名，才能成功連結：

#pragma comment(linker, "/alternatename:fileno=_fileno")
#pragma comment(linker, "/alternatename:getpid=_getpid")
#pragma comment(linker, "/alternatename:strdup=_strdup")

[62740693]

​

PIX

載入大型外部著色器 PDB 快取變得更可靠且一致。[63014983]

​

PIX DirectStorage

修正在計時擷取中從 Element Details 檢視或 Range Details 檢視瀏覽時，導致縮放行為不正確的問題。[62664029]

修正在深色模式下，計時擷取時間軸中標示 DirectStorage 批次開始的菱形標記難以辨識的問題。[62664035]

​

XBOX Manager

修正在 Remote Control 索引標籤中檢視主機或群組的影片時，可能發生的 XBOX Manager 當機。[62844048]

​

PlayFab Game Saves

修正 Steam Deck 上的輕微遙測回報問題，這些問題會導致某些診斷欄位在存檔作業期間填入不正確的值。[62642608]

停用 Steam Deck 上的衝突落敗方上傳功能，以符合 XBOX/GRTS 的行為。[62642612]

修正 PlayFab Game Saves 未正確處理遺失的登錄機碼，導致初始化錯誤的問題。[62642607]

​

Social Manager

修正當初始 People Hub 好友清單要求從未完成時，Social Manager 好友清單可能會間歇性地在整個工作階段中保持空白 (XblSocialManagerDoWork 未引發 LocalUserAdded 事件) 的問題。初始要求現在會自動復原，因此不需要重新啟動遊戲即可填入社交圖形。[63202269]

修正好友正在玩的遊戲顯示名稱包含連字號時，Social Manager 傳回不正確的遊戲名稱和豐富狀態文字的問題。原因是狀態字串在第一個連字號處分割，而不是在預期的「空格-連字號-空格」分隔符號處分割。[63202289]

​

PlayFab Party

修正遊戲尚未設定音訊輸出時，音訊操作語音串流未產生任何緩衝區的問題。[63294702]

修正在音訊操作作用中時切換網路，可能遺失語音的問題。[63294760]

修正音訊操作擷取串流作用中時，遺失最終語音轉文字轉錄的問題。[63294760]

修正在 Party 完成關機之前刪除處理序工作佇列時，關機時可能發生的當機。[63294760]

修正內部 HTTP 追蹤物件可能在背後的非同步工作完成之前遭到刪除，而可能發生釋放後使用的問題。[63294760]

修正在某些 WMI 登錄設定錯誤的電腦環境中，PlayFab Party 無法繫結至其 UDP 多人遊戲連接埠的錯誤。[63251323]

​

Publisher Content

修正 XTaskQueue 中的內部錯誤，以防止在終止期間發生無限等待。[63190218]

​

MSIXVC2

即使 Intelligent Delivery layout.xml 中有多個功能使用相同的影像檔，現在也可以成功建立 MSIXVC2。[63117723]

MSIXVC2 pack 命令會順利忽略 /maxencryptionfragments 和 /nogameos 選項 (這些選項對 MSIXVC2 沒有作用)，以便更容易放入現有的建置管線中。[63118134]

MSIXVC2 pack 命令現在會正確包含來源目錄中屬於符號連結的檔案。先前會錯誤地將這些檔案視為長度為 0 的檔案。[63118309]

​

2026 年 4 月 GDK Update 2

​

通知

​

開發人員工具

適用於 Visual Studio 2019 的 Direct3D 12 Desktop Game (Classic) 範本不再具有 ARM64 組態。已淘汰使用 Visual Studio 2019 以 ARM64 為目標的支援。需要 Visual Studio 2022 或更新版本。[62468394]

​

提供 Markdown 檔案

GDK 安裝程式已新增包含 GDK 文件 Markdown 檔案的 .zip 檔案。先前，此 .zip 檔案只能從 https://aka.ms/gdkdl 另行下載。[62398050]

​

問題修正

​

輸入

修正在 XBOX 上的 NuGet 版 GameInput 中呼叫 GameInputCreate 時，可能發生記憶體不足錯誤的問題。[62353092]

​

PIX

修正開啟在 Lockhart 40GB 上擷取的擷取檔時，PIX 錯誤地將主機模式回報為 Lockhart 的問題。[62490828]

​

媒體

修正在未提交輸入影片樣本的情況下建立並終結解碼器時，導致 H.264 解碼器 Media Foundation Transform (MFT) 在終結期間停止回應的問題。[62525251]

​

系統

修正未簽署 (本機) 的 MSIXVC2 套件無法使用 wdapp 安裝的問題。[62386086]

​

2026 年 4 月 GDK Update 1

​

通知

​

XBOX Game Package Manager

建立和上傳 MSIXVC2 套件時，請使用 GitHub 上最新的 XBOX Game Package Manager (XGPM) UI 版本。此版本包含多項修正。若要下載，請前往 releases - Microsoft/PackageUploader。

​

問題修正

​

系統

修正 XGameActivationAcceptPendingInvite API 中的記憶體流失。[61953160]

修正 XLaunchUri 在 URI 長度超過 21 個字元時失敗的問題。[62181431]

修正 XGameInvite.h 和 XGameProtocol.h GDK 標頭檔中可能導致 C4768 編譯器錯誤的問題。[62181564]

​

MSIXVC2

修正 MSIXVC2 預覽版本中的各種元件可靠性和效能問題。[62225080]

​

開發人員工具

修正 MicrosoftGame.config Editor 在回報成功的同時，卻在未提示的情況下無法儲存或建立新檔案的問題。[62226865]

​

2026 年 4 月 GDK

​

通知

​

GDK 配置淘汰

2025 年 10 月和 2026 年 4 月的 GDK 版本同時包含簡化配置和舊版配置。從 2026 年 10 月的 GDK 開始，安裝程式預設只會安裝簡化配置。舊版配置仍可選取為選擇性安裝，但已淘汰，且不再是建議的開發路徑。 從 2027 年 4 月的 GDK 版本開始，將不再支援舊版配置，並會從安裝程式中移除。

​

API 淘汰

XGameActivation API 已取代 XGameProtocol 和 XGameInvite API，為所有遊戲啟用案例提供單一 API 介面。因此，XGameProtocol 和 XGameInvite 現已淘汰。現有的實作會繼續運作，但我們建議移轉至 XGameActivation，以便進行新的開發並確保未來的相容性。 下列 API 已淘汰。

• XGameProtocolRegisterForActivation
• XGameProtocolUnregisterForActivation
• XGameInviteRegisterForEvent
• XGameInviteUnregisterForEvent
• XGameInviteRegisterForPendingEvent
• XGameInviteUnregisterForPendingEvent
• XGameInviteAcceptPendingInvite

如需詳細資訊，請參閱 XGameActivation。 [61232139]

​

開發人員工具

Visual Studio 2019 的主流支援已到期。延伸支援將持續到 2029 年 4 月。如需 Visual Studio 2019 產品生命週期和服務的詳細資訊，請參閱 Visual Studio 2019 產品生命週期和服務。 Visual Studio 2019 和 v142 工具組編譯器自 2024 年 4 月起已終止主流支援，僅接收安全性服務。未來的 GDK 版本將移除對 Visual Studio 2019 整合的支援，以及透過 Visual Studio 2022/Visual Studio 2026 使用 v142 平台工具組的支援。此程序將包括移除 Microsoft.Xbox.Services.142.GDK.C.lib 程式庫。對於 Visual Studio 2022 和 Visual Studio 2026，我們建議改用 2026 年 4 月 GDK 中新增的 Microsoft.Xbox.Services.143.GDK.C.lib。 [61594513]

Visual Studio 2019 不再支援適用於 XBOX 的 Address Sanitizer (ASAN)。[60868415]

現在可以從 XBOX Manager 的 Media Capture 索引標籤將螢幕擷取畫面複製到剪貼簿。[41667882]

wdcapture、wdcapturesession 和 xblpcsandbox 等電腦命令列工具現在支援透過意見反應中樞應用程式直接提交錯誤意見反應。[60250549]

Package Uploader 現在支援同盟認證。[60771527]

​

Microsoft Azure PlayFab

PlayFab Multiplayer 已更新至 v1.9.0。如需詳細資訊，請參閱 PlayFab Multiplayer C++ SDK 版本資訊 - PlayFab | Microsoft Learn。[61288995]

​

Microsoft Azure PlayFab Party

PlayFab Party 已更新至 v1.10.18。如需詳細資訊，請參閱 PlayFab Party 版本資訊 - PlayFab | Microsoft Learn。[61288995]

​

問題修正

修正在非英文命令提示字元中執行 xbapp.exe 或 xbconnect.exe 等 GDK XBOX 命令列工具後，語言設定變更為英文的問題。[59688191]

修正 XBOX Game Package Manager 未在 UI 中填入上次選取分支的問題。[60771527]

​

已知問題

​

makepkg2：/priorpackage 不會為 MSIXVC2 套件產生比較報告

問題：
在 makepkg2 中，封裝 MSIXVC2 套件時使用 /priorpackage 旗標不會產生比較報告。此版本不支援為 MSIXVC2 套件產生比較報告。 適用於：

• 2026 年 4 月 GDK

因應措施：
目前沒有。 狀態：
此問題將在未來的 GDK 更新中修正。 [61771743]

​

makepkg2：layout.xml 要求所有功能都必須有 DisplayName

問題：
在 makepkg2 中，layout.xml 剖析器要求所有功能都必須具有 DisplayName 屬性，包括顯示名稱沒有意義的隱藏功能。 適用於：

• 2026 年 4 月 GDK

因應措施：
在 layout.xml 中為任何隱藏功能新增預留位置 DisplayName 屬性。 狀態：
此問題將在未來的 GDK 更新中修正。 [61767246]

​

makepkg2：MicrosoftGame.config 中沒有 ContentId 時，/contentid 旗標會失敗

問題：
在 makepkg2 中，如果 MicrosoftGame.config 中未指定 ContentId，使用 /contentid 旗標會產生下列錯誤。 /contentid specified on the command line does not match the ContentId derived from the MicrosoftGame.config file. 此行為與 makepkg 不同，後者在此案例中會直接接受 /contentid 值。 適用於：

• 2026 年 4 月 GDK

因應措施：
使用 /contentidoverride 代替 /contentid。 狀態：
此問題將在未來的 GDK 更新中修正。 [61767256]

​

無法透過 Web UI 將 MSIXVC2 套件上傳至 Microsoft 合作夥伴中心

問題：
如果 .msixvc 套件是使用新的 makepkg2 工具建置的，將其上傳至合作夥伴中心會失敗。 適用於：

• 合作夥伴中心 Web UI

因應措施：
使用下列其中一個工具將 MSIXVC2 套件上傳至合作夥伴中心。

• makepkg2 upload 命令：makepkg2 upload /d <content_directory> /branch "<BranchName>" /msixvc2
• XBOX Game Package Manager：從 https://github.com/microsoft/PackageUploader 下載最新版本。

狀態：
合作夥伴中心將在未來幾個月內更新，以新增透過 Web 上傳 MSIXVC2 套件的支援。

​

XboxPcTray.exe 可能會阻止 MSIXVC2 套件解除安裝或更新

問題：
XboxPcTray.exe 有時會保留遊戲 Content 資料夾的控制代碼，這可能會導致解除安裝或更新作業無法完成。 適用於：

• 2026 年 4 月 GDK

因應措施：
嘗試解除安裝或更新之前，請先關閉 XBOX PC Tray 應用程式。若要關閉，請在系統匣中以滑鼠右鍵按一下 XboxPcTray 圖示，然後選取 Quit。您也可以在工作管理員中結束 XboxPcTray.exe 處理序。 狀態：
此問題將在未來的 GDK 更新中修正。 [61618609]

​

無法透過 Package Uploader 上傳 MSIXVC2 套件

問題：
如果 .msixvc 套件是使用 makepkg2 工具搭配 /msixvc2 旗標建置的，透過 Package Uploader 命令列工具將其上傳至合作夥伴中心會失敗，並出現 400 (Bad Request) 錯誤。雖然 MSIXVC 和 MSIXVC2 套件使用相同的 .msixvc 副檔名，但 MSIXVC2 套件使用不同的內部格式，Package Uploader 目前不支援此格式。 適用於：

• Package Uploader CLI (PackageUploader.exe)

因應措施：
使用下列其中一個工具上傳 MSIXVC2 套件。

• makepkg2 upload 命令：makepkg2 upload /d <content_directory> /branch "<BranchName>" /msixvc2>
• XBOX Game Package Manager： 從 https://github.com/microsoft/PackageUploader 下載最新版本。

狀態：
此問題將在未來的 Package Uploader 版本中解決。

​

合作夥伴中心 UI 中的 MSIXVC2 套件大小顯示為 1 位元組

問題：
合作夥伴中心為已上傳的 MSIXVC2 套件顯示不正確的大小。無論套件大小為何，都會顯示 1 位元組。 適用於：

• 合作夥伴中心

因應措施：
目前沒有。 狀態：
此問題將在未來的 GDK 工具更新中修正。

​

適用於 Visual Studio 2026 的 Build With/Out Install (BWOI) MSBuild 整合

問題：
適用於 Visual Studio 2026 的 Build With/Out Install (BWOI) MSBuild 整合與先前版本略有不同。在目前的 Visual Studio 2026 版本中，BWOI 實作必須「鎖定」至特定的 VCTargetsPath。結果是所有專案都會以 v145 或 clang-cl 建置，即使 PlatformToolset 值設定為 v142 或 v143 也一樣。在標準 Visual Studio 案例中，這些較舊的工具組通常可以正確建置。 適用於：

• 2026 年 4 月 GDK

因應措施：
如需因應措施的詳細資訊，請參閱 BWOIExample。 狀態：
GDK 小組和 Visual Studio 小組正在努力於未來的 Visual Studio 版本中解決此問題。 [61855642]

​

文件

2026 年 4 月版 GDKX 的離線文件會由 GDKX 安裝程式安裝在您的開發電腦上。執行安裝程式之後，GDKX 的說明檔 (gdk.chm) 位於 C:\Program Files (x86)\Microsoft GDK\Documentation。

• 線上 GDKX 和 GDK 文件位於 Game Development Kit (GDK) 文件。

​

2025 年 10 月 Microsoft Game Development Kit (GDK) 版本資訊

​

簡介

​

關於本文件

• 新功能
• 版本資訊：
  • 2025 年 10 月 GDK Update 4
  • 2025 年 10 月 GDK Update 3
  • 2025 年 10 月 GDK Update 2
  • 2025 年 10 月 GDK Update 1
  • 2025 年 10 月 GDK
• 已知問題
• 文件

​

2025 年 10 月 Microsoft Game Development Kit 的新功能

• GDK 的發行分為兩種類型：主要版本 (著重於功能，每年兩次) 和更新 (著重於修正，視需求隨時發行)。
• 若要檢視完整的新功能章節，請參閱線上版的新功能。

​

2025 年 10 月 GDK Update 4

​

問題修正

​

PlayFab Game Saves

修正套用雲端資料夾刪除時，可能刪除從未同步之本機檔案的問題，並提高上傳進度回報的精細度，讓遊戲可以在壓縮期間以動畫顯示確定進度列。[63666969]

修正失敗的雲端儲存體傳輸被回報為成功的問題。這可能導致以遺失的資料完成存檔，並永久阻止該玩家的存檔在每部裝置上同步。[63475452]

修正可能導致同步期間遺失存檔資料、遊戲存檔共用 GDK 內容時發生記憶體損毀，以及驗證失敗的資訊清單處理不正確的問題。[63647898]

修正遊戲存檔同步進度回呼回報總大小為零，導致遊戲無法顯示確定進度列的問題。[63529869]

​

2025 年 10 月 GDK Update 3

​

通知

​

註冊檔案類型關聯

電腦遊戲現在可以在 MicrosoftGame.Config 中註冊檔案類型關聯。當使用者開啟具有已註冊副檔名的檔案時，遊戲會啟動或移至前景。此行為是透過 XGameActivation* API (例如 XGameActivationRegisterForEvent()) 啟用的。

​

輸入

使用簡單處理序間通訊 (SIPC) 的動作感應控制器現在共用電腦感應器融合管線。加速度計和陀螺儀縮放、啟動時的陀螺儀偏差擷取，以及以靜止狀態為基礎的漂移修正，都已與電腦達到同等水準。因此，IGameInputReading::GetMotionState 會傳回相對於重力且漂移有限的方向。

​

PlayFab Game Saves

在 Steam Deck 上選擇 Keep Local 或 Keep Cloud 時，保留並復原至已捨棄遊戲存檔的功能已停用，以符合 XBOX/Gaming Runtime Services (GRTS) 的行為。

​

問題修正

​

網路

修正程式庫在偵錯工具中暫停時失去 WebSocket 連線後，可能會當機的問題。

​

XBOX 服務

修正以 WinHTTP 為基礎的 HTTP 呼叫可能因 libHttpClient 中的釋放後使用狀況而變得不穩定的問題。

​

輸入

修正在 XBOX 上的 NuGet 版 GameInput 中呼叫 GameInputCreate 時，可能發生記憶體不足錯誤的問題。

修正繼續執行已暫停的遊戲後，輸入可能遺失的問題。

​

媒體

修正在未提交輸入影片樣本的情況下建立並終結解碼器時，導致 H.264 解碼器 Media Foundation Transform (MFT) 在終結期間停止回應的問題。

​

PlayFab Game Saves

修正 PFGameSaves 未正確處理遺失的登錄機碼，導致初始化錯誤的問題。

修正 Steam Deck 上的輕微遙測回報問題，這些問題會導致某些診斷欄位在存檔作業期間填入不正確的值。

​

2025 年 10 月 GDK Update 2

​

通知

​

Microsoft Azure PlayFab Party v2.2.7 更新

• 已變更 PartyNetwork::CreateEndpoint PartyStatusChangeResult 行為，對於權杖到期前發生的暫時性錯誤會傳回 PartyServiceError，只有在權杖實際到期時才會傳回 UserNotAuthorized。
• 新增對無 XUser 或同處理序 Gaming Runtime Services (GRTS) 環境的音訊裝置選取支援。
• 修正多網路轉換案例期間可能發生的當機。

​

PlayFab Party v1.10.16 更新

• PartyNetwork::CreateEndpoint PartyStatusChangeResult 行為已變更，對於權杖到期前發生的暫時性錯誤會傳回 PartyServiceError，只有在權杖實際到期時才會傳回 UserNotAuthorized。
• 已新增對無 XUser 或同處理序 Gaming Runtime Services (GRTS) 環境的音訊裝置選取支援。
• 已修正多網路轉換案例期間可能發生的當機。

​

XBOX 服務

新增在同處理序 xgamingruntime 中啟用偵錯工具追蹤輸出的支援，與現有的 Gaming Runtime Services (GRTS) 功能一致。 若要在 Visual Studio 輸出視窗中啟用 HTTP/WebSocket 追蹤訊息，請將 HKEY_LOCAL_MACHINE\Software\Microsoft\GamingServices\Auth\TraceToDebugger (REG_DWORD) 登錄機碼設定為 1。此設定適用於偵錯網路問題、Proxy 設定和驗證問題。此功能需選擇加入，停用時不會造成任何影響。

​

網路

XCurl 已更新，允許在呼叫 curl_global_cleanup() 之間多次呼叫 xcurl_global_init_mem() 或 curl_global_init_mem()。此新行為與 LibCurl 對 curl_global_init_mem() 的行為一致，讓 XCurl API 與 LibCurl 的預期保持同步。此外，curl_global_init()、curl_global_init_mem()、xcurl_global_init_mem() 和 curl_global_cleanup() 已成為執行緒安全。

​

packageutil compare Intelligent Delivery 標籤模擬修正

packageutil compare 中的邏輯錯誤導致每次執行任何以標籤為基礎的模擬時，Intelligent Delivery 模擬都會排除必要的非 OnDemand 標籤。這會為使用 OnDemand 或以 Feature 為基礎之封裝的遊戲產生不準確的大小和更新預測。 此修正可確保：

• 對於非 Feature 套件，模擬中一律會包含非 OnDemand 標籤。
• 完整支援以 Feature 為基礎的套件，包括分段標籤，以及完整功能和單一功能模擬。

此修正可還原準確的大小回報，讓合作夥伴能夠正確評估 ID 設定。 受影響的二進位檔：PackageUtil.exe

​

問題修正

​

GDK 工具

修正 GDK Tools 安裝程式中包含的 GDK 命令提示字元未正確包含工具所在之 GDK bin 目錄的問題。

修正導致 XblTestAccountGui 工具無法登入並出現下列錯誤訊息的問題。 Live auth error: Login Error: The remote server returned an error: (400) Bad Request.

修正使用 /features 命令列參數以無訊息方式安裝 GDK 時，略過安裝舊版配置元件的問題。

​

Microsoft Azure PlayFab Game Saves

修正遊戲使用 PlayFab Game Saves 時，繼續執行時發生 FAIL_FAST 的問題。

修正使用同處理序 PlayFab Game Saves 時，在沒有實際裝置衝突的情況下，可能錯誤叫用裝置爭用回呼的問題。先前，PlayFab SDK 會將沒有暫止資訊清單視為另一部裝置已接手的證明。不過，這種情況也可能在正常案例中發生 (例如，沒有進行中的同步，或本機裝置已完成自己的上傳)。SDK 現在會在觸發爭用回呼之前，正確驗證已完成的資訊清單是否確實由其他裝置建立，以防止向遊戲發出誤判通知。

修正如果指定的存檔資料夾目錄尚不存在，或提供的路徑缺少結尾反斜線，PlayFab Game Saves 在 Gaming Runtime Services (GRTS) 上初始化失敗的問題。PlayFab SDK 現在會在需要時自動建立目錄，並在初始化之前確保路徑格式正確。

修正同處理序版 PlayFab Game Saves 在已完成的雲端資訊清單版本已超過過時的暫止資訊清單之後，仍可能錯誤地重複使用該暫止資訊清單的同步問題。現在只有在暫止資訊清單同時屬於目前裝置且版本大於已完成的雲端版本時，才會重複使用。此變更可防止多裝置同步案例期間可能發生的資料不一致。

修正使用不同儲存體提供者 (同處理序與 Gaming Runtime Services (GRTS)) 在裝置之間同步遊戲存檔時，檔案修改時間戳記不正確的問題。現在建立壓縮封存時，會正確保留檔案時間戳記並轉換為 UTC，確保所有平台上的時間戳記行為一致。

修正 Game Save 描述在 Steam Deck 上傳回格式錯誤/損毀資料的問題。現在從資訊清單擷取存檔描述時，會正確進行 Base64 解碼，確保您取得最初設定的正確可讀描述文字。

修正使用同處理序 PlayFab Game Saves 時，從進度對話方塊取消同步作業可能導致判斷提示失敗和不穩定行為的問題。取消機制已重新設計為使用執行緒安全的不可部分完成旗標方法。 此變更可讓使用者從進度 UI 安全地取消進行中的上傳或下載作業，而不會觸發競爭情形或判斷提示失敗。SDK 現在會在同步作業的關鍵階段正確檢查取消要求，並以使用者已取消的錯誤碼乾淨地終止。

修正使用同處理序 PlayFab Game Saves 時，下載大量小型檔案 (例如 1,000 個以上的小型文字檔) 會失敗的問題。進度追蹤錯誤地使用未壓縮的檔案大小來回報傳輸進度，導致處理許多已壓縮的小型檔案時發生不相符。進度回報現在會正確追蹤壓縮後的位元組大小，以準確反映實際的網路傳輸進度。

修正使用同處理序 PlayFab Game Saves 時，在與雲端中斷連線的情況下呼叫 PFGameSaveFilesSetSaveDescriptionAsync API 所發生的當機。此 API 現在會傳回適當的錯誤碼，而不會當機。

修正 PFUninitializeAsync() 在使用同處理序 PFGameSaveFiles 時，如果關機期間有同步失敗回呼正在等待回應，就會停止回應的問題。SDK 現在會在解除初始化時自動取消暫止的 UI 回呼，即使遊戲未回應 syncFailedCallback，也能確保乾淨地關機。

修正使用 PlayFab Game Saves 變更作用中裝置時，遊戲可能當機的問題。

修正使用同處理序 PlayFab Game Saves 時，衝突回呼顯示不正確時間戳記的問題。

修正在 Steam Deck 上離線呼叫 PFGameSaveFilesSetSaveDescriptionAsync 時，傳回 E_FAIL 且後續呼叫停止回應的問題。

修正在 Steam Deck 上取消失敗的上傳後，所有後續上傳都永久失敗並出現 E_PF_GAME_SAVE_MANIFEST_UPDATES_NOT_ALLOWED 的問題。

修正如果先前的上傳在服務錯誤期間遭到取消，PFGameSaveFilesUploadWithUiAsync 可能無限期停止回應的問題。現在重試時會正確顯示同步失敗 UI 回呼，讓使用者可以取消或重試作業。

​

網路

修正在第一次嘗試大廳或配對的 24 小時後，如果尚未清除程式庫，可能無法建立後續大廳、加入後續大廳、訂閱大廳邀請或建立後續配對票證的問題。

​

XBOX 服務

修正在下列兩種特定情況下，Steam Deck 上未觸發遊戲邀請回呼的問題。

• 邀請未提供 Multiplayer Activity Connection String 時
• 遊戲在已新增 XUser 之後才新增邀請處理常式時

修正同處理序遊戲執行階段未使用 WinHTTP Proxy 設定，導致透過 netsh winhttp set proxy 設定 Proxy (例如 Fiddler) 時發生 E_XAL_NETWORK 錯誤的問題。

​

2025 年 10 月 GDK Update 1

• GDKX 和 GDK 的發行分為兩種類型：主要版本 (著重於功能，每年兩次) 和更新 (著重於修正，視合作夥伴需求隨時發行)。
• 若要檢視完整的新功能章節，請參閱線上版的新功能。
• 若要檢視舊版的版本資訊，請參閱 GDK 論壇上的版本資訊文章，或在線上文件的 GDK 版本資訊中檢視版本資訊。

​

通知

​

API 淘汰

XGameActivation API 已取代 XGameProtocol 和 XGameInvite API，為所有遊戲啟用案例提供單一 API 介面。因此，XGameProtocol 和 XGameInvite 現已淘汰。現有的實作會繼續運作，但我們建議移轉至 XGameActivation，以便進行新的開發並確保未來的相容性。 下列 API 已淘汰。

• XGameProtocolRegisterForActivation
• XGameProtocolUnregisterForActivation
• XGameInviteRegisterForEvent
• XGameInviteUnregisterForEvent
• XGameInviteRegisterForPendingEvent
• XGameInviteUnregisterForPendingEvent
• XGameInviteAcceptPendingInvite

如需詳細資訊，請參閱 XGameActivation。 [61232139]

​

跨平台功能

已新增 XUserSignOutAsync 和 XUserSignOutResult，以支援在 Steam Deck 上登出玩家。XUserIsSignOutPresent 可用來判斷目前裝置是否支援透過 API 登出。[59457172]

​

XBOX 服務

已新增三個新的 API：XGameInviteRegisterForPendingEvent、XGameInviteUnregisterForPendingEvent 和 XGameInviteAcceptPendingInvite，以恢復 XGameInvite 回呼的一致性，這些回呼先前在同處理序和跨處理序案例中的行為不一致。新的暫止邀請處理常式只會在同處理序流程中呼叫。遊戲處理邀請接受之後，會呼叫 XGameInviteAcceptPendingInvite。這會觸發邀請已接受回呼。 在 Windows 和 XBOX 主機上 (可使用 Gaming Runtime Services (GRTS) 的平台)，由殼層 UI 負責邀請接受流程。遊戲只會在邀請被接受時收到通知。在同處理序案例 (例如 Steam Deck) 中，由遊戲處理邀請接受。收到邀請時會觸發 XGameInvite 回呼，讓遊戲可以管理接受流程。 [59693389]

​

圖形

針對 XBOX One 系列，新增了 D3D12XBOX_PIPELINE_STATE_FLAG_VS_EXPORT_VIEWPORT_INDEX_REUSE 旗標，以防止在使用索引重複使用和匯出 SV_ViewportArrayIndex 的頂點著色器時發生重複資料刪除問題。[59989696]

​

系統

現在可以在 XBOX 上初始化 DirectStorage 時縮減 StagingBuffer 的大小，以釋放遊戲記憶體。 現在提供列舉值，與預設的 32 MB 暫存大小相比，最多可節省 16 MB 的緩衝區。不過，使用較小的緩衝區時，檔案效能會稍微降低。如需詳細資訊，請參閱 DirectStorage。 [60006847]

現在提供新的介面 IDStorageFactoryX2。它公開了用於建立 DirectStorage 佇列的新 API CreateQueue1。此 API 接受新的佇列定義結構，可控制是否在新建立的 DirectStorage 佇列中進行自動提交。如需詳細資訊，請參閱 DirectStorage。[60039148]

2025 年 10 月 GDK 引進了 XGameUi 回呼。這些回呼可讓開發人員在 Steam Deck 平台上實作自己的 UX。其中幾個回呼 (特別是沒有任何使用者互動之 UI 元件的回呼) 沒有相關聯的 SetResponse API，而這些 API 負責完成非同步 UI 呼叫。現在已引進這些 API，讓開發人員可以在 Steam Deck 上完成所有 XGameUi 呼叫。[60149696]

​

Microsoft Azure PlayFab Game Saves

上傳進度追蹤現在會回報壓縮後的位元組計數。此變更可讓進度回呼和遙測與實際串流的資料保持一致，並防止大型存檔壓縮效果不佳時過早顯示「已完成」百分比。[60147964]

先前處於休眠狀態的 PFGameSaveFilesAddUserOptions::RollbackToLastKnownGood 和 RollbackToLastConflict 旗標已啟用。它們現在會在 PFGameSaveFilesAddUserWithUiAsync 期間接受復原要求。遊戲會取得預期的選擇，而不是一律同步至最新的存檔。[60147982]

初始化現在會在 E_INVALIDARG 失敗 (例如缺少 Steam Deck 存檔路徑) 後正確清除。此變更可確保後續呼叫不再回報「已初始化」。[60148008]

已新增記錄功能，以改善在處理序外執行時的診斷。[60148021]

​

PIX

轉換程式設計方式的計時擷取時，UI 中的 GPU Only Events 設定會遭到忽略。這些設定現在會套用至轉換後的擷取。[60294683]

​

問題修正

​

Microsoft Azure PlayFab Party

修正沒有已登入的 XUser 時無法建立 PlayFab Party 語音聊天的問題，包括在 Windows 上沒有 XBOX 網路使用者遊玩的 Steam 遊戲，以及在 Steam Deck 上。[59804895]

​

XBOX 服務

修正遊戲在 Steam Deck 上從 XGameInvite 回呼收到的 URI 與在 Windows 上收到的 URI 不符的問題。Steam Deck URI 只包含連接字串，但缺少傳送者資訊和受邀使用者的 XUID。[59990660]

​

系統

修正同處理序 XGameRuntime 中 XGameGetXboxTitleId 失敗並出現 E_GAMERUNTIME_SERVICE_NOT_AVAILABLE 的問題。此失敗產生連鎖效應，導致其他 XBOX API 失敗，包括 XblMultiplayerActivitySendInvitesAsync。[60043213]

修正遊戲呼叫 XLaunchNewGame 之後，Visual Studio 中的 Break On Suspend Timeout 設定未生效的問題。[60063672]

​

圖形

修正使用差異色彩壓縮 (DCC) 的呈現緩衝區未遵守 D3D12XBOX_RESOURCE_FLAG_FORCE_TEXTURE_COMPATIBILITY 旗標的問題。[60237976]

​

GDK 工具

修正從 XBOX One GDK 命令提示字元或 Scarlett GDK 命令提示字元執行錯誤版本 dxc.exe 的問題。執行的是 Windows 版本，而不是 XBOX 版本。[60265047]

​

PIX

修正搭配簡單 DispatchMesh 命令使用 ExecuteIndirect 時，Mesh Shader Output 顯示錯誤的問題。[60270639]

​

2025 年 10 月 GDK

​

通知

​

GDK 配置淘汰

2025 年 10 月和 2026 年 4 月的 GDK 版本同時包含簡化配置和舊版配置。從 2026 年 10 月的 GDK 開始，安裝程式預設只會安裝簡化配置。舊版配置仍可選取為選擇性安裝，但已淘汰，且不再是建議的開發路徑。 從 2027 年 4 月的 GDK 版本開始，將不再支援舊版配置，並會從安裝程式中移除。

​

GDK 工具

MakePkg 已新增 /updatesubval 旗標，用於檢查是否有較新版本的 SubmissionValidator.dll。如果使用此旗標且有較新版本的 SubmissionValidator.dll 可用，MakePkg 會下載該 .dll 檔案並放在 MakePkg 的路徑中。[56987338]

Touch Adaptation Kit Command Line Tool (TAK CLI) (tak.exe) 已從 GDK 安裝程式中移除。如需如何下載此工具的指示，請前往 GitHub 上的 TAK CLI。[57605599]

​

問題修正

​

圖形

修正 XBOX Series X|S 主機上 Direct3D 12 驅動程式中的問題，該問題導致以錯誤的大小建立區塊壓縮資源的非區塊壓縮檢視 (Shader Resource View (SRV) 和 Unordered Access View (UAV))。[57051436]

​

已知問題

​

離線 Markdown .zip 檔案

問題：
目前無法取得離線 Markdown .zip 檔案。 適用於：

• 2025 年 10 月 GDK
• 2025 年 10 月 GDK Update 1

指引：
您仍然可以從 https://aka.ms/gdkdl 下載編譯的 HTML 說明 (.chm) 檔案格式的離線文件。 [60279334]

​

XUserResolveIssueWithUiAsync 流程

問題：
XUserResolveIssueWithUiAsync API 的用途是解決使用者帳戶問題 (例如權杖或同意問題)，而不是變更已登入的身分識別。不過，最初以帳戶 A 登入的使用者有可能完成此流程並以帳戶 B 登入，導致 XUID 不同。 影響：
當帳戶在此流程期間變更時，API 會偵測到不相符並自動使作業失敗。 適用於：

• 2025 年 10 月 GDK
• 2025 年 10 月 GDK Update 1

指引：
如果作業因帳戶變更而失敗，請移除使用者並重新新增使用者，以確保正確登入。 [59960311]

​

下載壓縮的存檔資料

問題：
下載壓縮後大小大於未壓縮大小的存檔資料時，PlayFab Game Saves 可能會遇到問題。這最常發生在遊戲除了 PlayFab Game Saves 之外還使用自己的檔案壓縮時。 適用於：

• 2025 年 10 月 GDK
• 2025 年 10 月 GDK Update 1

指引：
如果可能，請考慮停用額外的檔案壓縮。 狀態：
這將在未來的 GDK 更新中修正。 [60348127]

​

XblTestAccountGui 工具測試帳戶錯誤

問題：
XblTestAccountGui 工具可能無法登入測試帳戶。如果發生此情況，會出現下列錯誤訊息。 Live auth error: Login Error: The remote server returned an error: (400) Bad Request. 適用於：

• 2025 年 10 月 GDK
• 2025 年 10 月 GDK Update 1

狀態：
此問題已在 XBOX Live 開發人員工具的最新 GitHub 版本中修正。這些工具可從 https://aka.ms/xbltools 取得。此修正將包含在未來的 GDK 版本中。 [60428977]

​

必須在新增 XUser 之前呼叫 XGameInviteRegisterForPendingEvent

問題：
在 Steam Deck 上，必須在新增 XUsers 之前呼叫 XGameInviteRegisterForPendingEvent，否則它們不會正確註冊邀請通知。此順序需求並非刻意設計。 適用於：
2025 年 10 月 GDK Update 1 狀態：
此問題將在未來的 GDK 版本中修正。 [60470935]

​

XGameInviteRegisterForPendingEvent 需要設定 connectionString

問題：
在 Steam Deck 上，對於缺少 XBOX Multiplayer Activity (MPA) connectionString 的邀請，XGameInviteRegisterForPendingEvent 不會叫用遊戲回呼。雖然傳送邀請時這是選擇性欄位，但 XGameRuntime 會捨棄沒有此欄位的邀請承載。

適用於：
2025 年 10 月 GDK Update 1 因應措施：
傳送邀請時請提供非空白的連接字串。如果接收端不需要，可以忽略它。 狀態：
此問題將在未來的 GDK 版本中修正。 [60470935]