包含的內容
適用於 Unreal Engine 的 Microsoft GDK 外掛程式為建置 PC 版 XBOX 遊戲提供基礎,涵蓋商店封裝、GDK 執行階段存取、XBOX services、GameInput 等。主要外掛程式包括:- Microsoft GDK Store (MSGameStore): 在編輯器中設定遊戲,並直接從 Project Settings 為 PC 版 XBOX 產生
.msixvc套件。 - Microsoft GDK Runtime (MSGamingRuntime): 在執行階段存取 GDK API,以使用與 XBOX 相容的遊戲存檔、使用者選擇和系統 UI。
- Online Subsystem GDK: 使用 Unreal Engine 的平台抽象層來管理成就、好友、上線狀態等。
- Online Subsystem Selector for PC GDK (MSGameOSSSelector,5.8 新增): 在多個 PC 商店中發行單一可執行檔,並在執行階段自動切換 Online Subsystem 行為。
為何這很重要
以往,在 Unreal Engine 中建置 PC 版 XBOX 遊戲需要使用 WinGDK,這是一個獨立平台,需要重複 cook,並造成協力廠商外掛程式的平台不相容問題。它也採用與其他 PC 商店不同的 PC 遊戲建置模式,增加了阻礙。新的外掛程式模式消除了這些問題。您可以留在 Win64 上,現有的協力廠商外掛程式可繼續運作,而且工作流程就像其他 PC 商店一樣,是引擎中 Win64 平台更精簡的一部分。 此外,在此之前,存取這些外掛程式需要經過管控的存取權限,屬於私人 GDK Platform Extensions 的一部分,這些擴充功能提供在 Unreal Engine 中進行 XBOX Series X|S 和 XBOX One 開發的功能。從 Unreal Engine 5.8 版開始,用於為 PC 版 XBOX 建置的外掛程式已公開,任何 Unreal Engine 開發人員都能找到並下載。沒有門檻,無須等待。取得外掛程式的方式
下表依引擎版本摘要說明如何取得外掛程式。來自 GitHub 的 Unreal Engine 原始碼 (建議遊戲團隊使用)
對於遊戲團隊,我們建議使用來自 GitHub 的 Unreal Engine 原始碼。完整的原始碼存取權可實現深度自訂、偵錯進入引擎程式碼,以及整合遊戲專屬修正和最佳化的能力。- 在 unrealengine.com/ue-on-github 將您的 Epic Games 帳戶連結到 GitHub 帳戶。
- 連結後,您即可存取 EpicGames/UnrealEngine 私人存放庫。
- 複製或下載 Unreal Engine 5.8 原始碼。GDK 外掛程式位於引擎原始碼中:
Engine\Plugins\Runtime\Windows\MSGameStoreEngine\Plugins\Runtime\Windows\MSGamingRuntimeEngine\Plugins\Online\Microsoft\OnlineSubsystemGDKEngine\Plugins\Runtime\Windows\MSGameOSSSelector
- 執行
Setup.bat和GenerateProjectFiles.bat以設定組建環境。 - 依照 從原始碼建置 Unreal Engine 指南從原始碼建置引擎。
從 GitHub 原始碼建置時,GDK SDK 版本相容性定義於
Engine\Config\Microsoft\GDK_SDK.json。Unreal Engine 5.8 支援廣泛的 GDK 版本,最高至 2026 年 4 月 GDK (版本 250404 到 260499)。您可以使用 winget install Microsoft.Gaming.GDK 安裝 GDK。Epic Games Launcher
如果您不需要原始碼存取權,可以透過 Epic Games Launcher 下載 Unreal Engine。自 Unreal Engine 5.8 起,Microsoft GDK 外掛程式會公開隨附於引擎下載中。- 如果您尚未安裝 Epic Games Launcher,請先安裝。
- 從啟動器的 [Unreal Engine] 索引標籤安裝 Unreal Engine 5.8 或更新版本。
- Microsoft GDK 外掛程式會自動包含在內。不需要額外下載或提出存取要求。
GDK Platform Extensions (Unreal Engine 5.7)
對於 Unreal Engine 5.7,GDK 外掛程式是 GDK Platform Extensions 的一部分。這些擴充功能需要加入 XBOX 開發人員計畫 (例如 ID@XBOX),並另外提出存取要求。- 加入 XBOX 開發人員計畫,例如 ID@XBOX。
- 使用 存取要求表單,要求存取 Unreal Engine 的 Developer Community GDK 群組。
- 核准後,下載 GDK Platform Extensions。外掛程式位於
Engine\Platforms\GDK\Plugins資料夾中。
如何開始使用
- 安裝 Unreal Engine 5.8,可透過 GitHub 原始碼 (建議) 或 Epic Games Launcher 取得。
- 安裝 Microsoft GDK。 Unreal Engine 5.8 支援廣泛的版本,最高至 2026 年 4 月 GDK。從終端機使用
winget install Microsoft.Gaming.GDK安裝,或從 aka.ms/gdkdl 下載。 - 在外掛程式功能表中啟用 Microsoft GDK 外掛程式,並在 MS Gaming (PC GDK) 下設定 Project Settings,以將遊戲與 Microsoft Partner Center 建立關聯。
- 設定及封裝遊戲: 設定中繼資料,並直接從編輯器產生
.msixvc套件。
若要在 XBOX 上發佈遊戲,您需要 註冊 ID@XBOX。註冊程序約需 30 分鐘,在申請處理期間,您就可以開始使用 GDK 和外掛程式進行建置。
資源
- 適用於 Unreal Engine 的 Microsoft GDK 外掛程式文件
- 開始使用 Unreal Engine 進行 PC 開發
- Press Start: Get Your PC Game Ready for XBOX in One Day
- 註冊 ID@XBOX
- GitHub 上的 XBOX GDK 範例
