本部分介绍所有 Microsoft 游戏开发工具包 (GDK) 开发所需的设置步骤,以及支持开发电脑版和 Xbox 版 Microsoft 游戏开发工具包 (GDK) 游戏所需的平台特定设置步骤。 如果针对主机进行开发,则需要使用 Xbox 扩展 (GDKx) 安装Microsoft游戏开发工具包。
若要开始使用 Microsoft 游戏开发工具包 (GDK),需要首先完成设置开发人员环境中的步骤。
如果要针对主机进行开发,则应按照 设置开发环境后设置 Xbox 开发工具包要求授权 中的步骤进行作。 设置 Xbox 开发工具包后,可以选择查看 运行 Xbox 主机示例要求授权 和 Xbox One Microsoft游戏开发工具包移植指南要求授权。
如果使用中间件引擎,可以在一组 端到端指南中找到帮助你入门的其他内容。 为 Unity、Unreal、GameMaker 和自定义游戏引擎提供了端到端指南。
设置开发环境
按照为游戏运行时游戏开发设置开发电脑中的步骤,设置电脑以准备使用 GDK 或 GDK 和 Xbox 扩展 进行开发。
创建新的 GDK 项目或将 GDK 集成到现有桌面项目
下一步是创建新的 GDK 项目(如果从头开始创建)或将 GDK 集成到现有桌面项目中。
- 若要创建新项目,请按照使用 GDK 项目模板开始开发新游戏中的说明进行操作
- 若要将 GDK 集成到现有项目中,请按照将 GDK 添加到现有桌面项目中的说明进行操作
准备进行 Xbox 服务开发
若要利用成就和云保存等功能,需要将 Xbox 服务功能集成到游戏中。
有关 Xbox 服务开发的详细信息,请参阅 Xbox 服务入门。
我们建议安装 Xbox 应用,以帮助管理电脑上的 Xbox 服务登录。
如果你的游戏支持 Xbox 服务多人功能,则必须安装 Xbox Game Bar(从 Microsoft Store 安装)。
注意
Xbox 游戏栏将自动包含在大多数 Windows 10 版本中。 对于测试,Xbox Game Bar 应始终更新到最新版本。
创建合作伙伴中心项目并将游戏配置为使用它
在为游戏创建合作伙伴中心项目并将游戏配置为使用合作伙伴中心项目中的值之前,你将无法测试 Xbox 服务功能
在合作伙伴中心创建产品
需要先在合作伙伴中心创建启用 Xbox 服务的产品,然后才能测试 Xbox 服务功能或将游戏发布到 Microsoft Store。 有关合作伙伴中心的更多信息,请参阅在合作伙伴中心设置应用或游戏,用于托管合作伙伴。
正在更新 MicrosoftGame.config
你在创建新的 GDK 项目或将 GDK 集成到现有桌面项目部分中创建项目时创建的 MicrosoftGame.config 文件具有默认值,允许在电脑和 Xbox 上进行早期开发,而无需进一步配置,直到开始使用游戏运行时、Microsoft Store和游戏标识中的功能。 若要使用 Xbox 服务功能,需要使用合作伙伴中心项目标识详细信息更新项目的 MicrosoftGame.config。
- 转到合作伙伴中心仪表板。
- 从产品列表中选择自己的游戏。
- 选择游戏设置选项卡,然后选择标识详细信息。
- 选择显示详细信息以展开标识详细信息部分。
- 使用标识详细信息部分的表中的以下值,然后将这些值从合作伙伴中心复制到 MicrosoftGame.config 中的相应元素和字段中。
合作伙伴中心中的名称 | MicrosoftGame.config |
---|---|
Xbox 游戏 ID | TitleId |
包/标识/名称 | 标识 ->名称 |
包/标识/发布者 | 标识 ->发布者 |
Xbox 服务 -> Xbox 设置 ->MSAAppId | MSAAppId |
例如,合作伙伴中心中的以下标识详细信息将导致你的 MicrosoftGame.config 看起来类似下面的示例:
合作伙伴中心中的名称 | 示例值 |
---|---|
Xbox 游戏 ID | 64353034 |
包/标识/名称 | 41336MicrosoftATG.Achievements2017Redux |
包/标识/发布者 | CN=A4954634-DF4B-47C7-AB70-D3215D246AF1 |
Xbox 服务 -> Xbox 设置 ->MSAAppId | 0000000000000000 |
<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
<Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />
<TitleId>64353034</TitleId>
<MSAAppId>0000000000000000</MSAAppId>
<ExecutableList>
<Executable Name="Achievements2017_desktop.exe"
TargetDeviceFamily="PC"
Id="Game"/>
</ExecutableList>
<ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
PublisherDisplayName="Xbox Advanced Technology Group"
StoreLogo="Assets\StoreLogo.png"
Square150x150Logo="Assets\Logo.png"
Square44x44Logo="Assets\SmallLogo.png"
Square480x480Logo="Assets\LargeLogo.png"
Description="Achievements2017"
ForegroundText="dark"
BackgroundColor="#000000"
SplashScreenImage="Assets\SplashScreen.png"/>
</Game>
有关 MicrosoftGame.config 中的值的其他信息,请参阅MicrosoftGame.config。
测试 Xbox 服务功能
若要测试游戏使用的 Xbox 服务功能,需要创建一个或多个测试帐户并切换到开发沙盒。
创建测试帐户
你需要创建一个可访问开发沙盒的测试帐户,以便能够测试 Xbox 服务功能。 有关创建测试帐户详细信息,请参阅 创建测试帐户。
切换开发沙盒
创建测试帐户后,请使用该帐户通过以下步骤访问开发沙盒。
- 若要查找沙盒的 ID,请转到“合作伙伴中心”。
- 导航到游戏。
- 在左侧导航窗格中选择 Xbox 服务>游戏设置。
注意
沙盒 ID 位于“游戏设置”页左上角的第一个选项卡上。 它的名称类似于“ABCDEF.0”。
- 打开开始菜单。
- 输入Microsoft GDK 命令提示符,然后在键盘上选择 Enter。
- 打开第一个命令提示符。
- 在命令提示符处,输入 XblPCSandbox.exe[你的沙盒 ID]。
- 命令提示符启动多个应用后,使用测试帐户登录到 Xbox 应用。
如果能够成功登录,则已创建测试帐户并更改为沙盒以开始测试。 如果在登录时遇到问题,请参阅疑 难解答登录和沙盒 文章以获取帮助。
远程电脑测试
你还可能会发现,对设置远程测试电脑和配置远程调试进行测试很有帮助。 有关详细信息,请参阅 Visual Studio 主题中的设置远程测试电脑和远程调试 C++ 项目。
打包游戏
若要发布游戏,需要先将游戏打包。 MSIXVC 是 Microsoft Store 所需的打包格式。 打包游戏需要一个 MicrosoftGame.config 文件,该文件可实现 Microsoft Store 中的游戏身份和特定于游戏的 Shell 视觉对象。 有关更多信息,请参阅 MicrosoftGame.config 概述。
若要开始打包电脑游戏,请参阅 电脑打包入门。
若要开始打包主机游戏,请参阅主机 打包入门。
注意
从 2022 年 3 月游戏服务版本开始,由于安装了 MSIXVC 包,文件在光盘上的布局方式已得到改进。 这些改进使游戏文件更易于发现,并简化了对已安装 MSIXVC 游戏的管理。 有关详细信息,请参阅 Flat 文件安装概述。
发布
准备好发布后,需要在合作伙伴中心中提交游戏。 转到“合作伙伴中心”并按照 UI 中的说明提交游戏。
有用的链接
利用 Microsoft 游戏开发工具包工具安装和启动电脑游戏
Xbox 开发和测试工具包概述要求授权
介绍 Xbox 开发和测试工具包。
Xbox 零售和开发工具包硬件规范要求授权
提供 Xbox Series X、Xbox Series X 开发工具包和 Xbox Series S 硬件规范。
在此部分中
设置开发人员环境
描述了为 Xbox 主机和 PC 开发游戏所需的常见设置步骤。
开始使用 PlayFab 运营 GDK 游戏
介绍如何开始将 PlayFab 用于 Microsoft 游戏开发工具包 (GDK) 游戏。
Xbox ATG 参与情况(NDA 主题)要求授权
介绍如何与 Xbox 高级技术组互动。