包含的内容
面向 Unreal Engine 的 Microsoft GDK 插件为构建 PC 上的 XBOX 游戏提供了基础,涵盖商店打包、GDK 运行时访问、XBOX 服务、GameInput 等。关键插件包括:- Microsoft GDK Store(MSGameStore): 直接在编辑器中配置你的游戏,并从 Project Settings 生成用于 PC 上 XBOX 的
.msixvc包。 - Microsoft GDK Runtime(MSGamingRuntime): 在运行时访问 GDK API,以支持 XBOX 兼容的存档、用户选择与 System 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 上,现有的第三方插件继续工作,工作流程作为引擎中 Win64 平台的一部分变得更加流畅,与其他 PC 商店一致。 在此之前,访问这些插件需要作为私有 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配置构建环境。 - 按照 Building Unreal Engine from Source 指南从源码构建引擎。
从 GitHub 源码构建时,GDK SDK 版本兼容性定义在
Engine\Config\Microsoft\GDK_SDK.json。Unreal Engine 5.8 支持从 250404 到 260499 的广泛 GDK 版本,包含到 2026 年 4 月 GDK 为止。你可以使用 winget install Microsoft.Gaming.GDK 安装 GDK。Epic Games Launcher
如果你不需要源码访问权限,可以通过 Epic Games Launcher 下载 Unreal Engine。自 Unreal Engine 5.8 起,Microsoft GDK 插件已随引擎下载公开提供。- 如果尚未安装 Epic Games Launcher,请先安装。
- 在 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 Developer 计划(例如 ID@XBOX)成员资格以及单独的访问申请。- 加入 XBOX Developer 计划,例如 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 下载。 - 在 Plug-in 菜单中启用 Microsoft GDK 插件,并在 MS Gaming (PC GDK) 下的 Project Settings 中进行配置,将游戏与 Microsoft Partner Center 关联。
- 配置并打包游戏: 直接在编辑器中设置元数据并生成
.msixvc包。
要在 XBOX 上发布游戏,你需要 注册 ID@XBOX。注册流程大约需要 30 分钟,你可以在申请审核期间就开始使用 GDK 与插件进行开发。
资源
- 面向 Unreal Engine 的 Microsoft GDK 插件文档
- 面向 PC 开发开始使用 Unreal Engine
- Press Start: Get Your PC Game Ready for XBOX in One Day
- 注册 ID@XBOX
- GitHub 上的 XBOX GDK 示例
