概述
本主题描述如何获取所需的 ID 以设置沙盒并配置你的应用程序以使用 XBOX 服务。 沙盒为单个开发工具包提供内容隔离，为开发和测试提供干净的环境。 XBOX 服务提供事件、成就和多人游戏功能等在线功能。 要启用沙盒并使用 XBOX 服务，你需要获取多个 ID 以配置你的开发工具包和标题。 这些可以通过相同的流程完成。 流程如下。- 获取你的 ID。
- 在你的开发工具包上设置沙盒。
- 将 TitleID 与其他可选标识符一起绑定到你的标题。
关键 ID
有三个 ID 对于为 XBOX One（或更高版本）开发标题和应用程序至关重要：沙盒 ID、TitleID 和服务配置标识符 (SCID)。 虽然使用开发工具包需要沙盒 ID，但初始开发不需要 TitleID 和 SCID，但使用任何 XBOX 服务都需要它们。因此，我们建议你同时获取所有三个 ID。沙盒 ID
沙盒在开发期间为你的开发工具包提供内容隔离，确保你在开发和测试标题时拥有一个干净的环境。沙盒 ID 用于标识你的沙盒。一个主机在任何时候只能访问一个沙盒，但一个沙盒可以被多个主机访问。 沙盒 ID 区分大小写。TitleID
TitleID 向 XBOX 服务唯一地标识你的标题。TitleID 在整个服务中使用，使用户能够访问诸如你标题的 XBOX 内容、他们的用户统计信息和成就等内容，并启用 XBOX 多人游戏功能。 Title ID 可能区分大小写，具体取决于它们的使用方式和位置。服务配置标识符 (SCID)
作为开发的一部分，你将创建事件、成就和许多其他在线功能。这些都是服务配置的一部分，需要 SCID 才能访问。 与之前版本的 XBOX OS 不同，为 Microsoft GDK Game OS 开发的标题只有一个 SCID，因此特定沙盒内的所有标题实例共享相同的配置。 Microsoft GDK Game OS SCID 始终是一个与 TitleID 值相同的 GUID，前面加上零。对于来自 Microsoft Game Development Kit (GDK) 标题与 XBOX 服务的大多数交互，不再需要显式指定 SCID，但如果直接与 XBOX 服务 REST 端点交互，则可能需要它。 SCID 区分大小写。获取你的 ID
目前，你将通过与你的开发人员客户经理合作来获取你的 ID。设置沙盒
在设置沙盒 ID 之前，你将无法启动开发工具包。为此，请打开一个 GDK 命令窗口，并使用 Configuration (xbconfig.exe)（NDA 主题） 命令，如下所示。- 检查你当前的沙盒。在命令提示符处输入 xbconfig sandboxid。
- 如果它不符合你的预期，请更改你的沙盒 ID。在命令提示符处输入 xbconfig sandboxid=<你的沙盒 id>。
- 在命令提示符处使用 Reboot (xbreboot.exe)（NDA 主题） 重启你的主机。
- 验证你的沙盒是否已正确重置。在命令提示符处输入 xbconfig sandboxid。
将 TitleID 和其他可选标识符添加到你的二进制文件
虽然沙盒是在每个开发工具包的平台级别进行配置的，但 TitleID 绑定到特定的二进制文件。要将 TitleID 添加到你的二进制文件，请通过在<Game> 节点中添加一个新节点来修改该二进制文件的 MicrosoftGame.config 文件，如下所示。
从 2022 年 3 月的 Microsoft Game Development Kit (GDK) 开始，如果在 MicrosoftGame.config 中指定了 MSAAppId 和 TitleId 中的任何一个，则两者都是必需的。有关更多信息，请参阅 MicrosoftGame.config Element - MSAAppId 和 MicrosoftGame.config Element - TitleId。
RequiresXboxLive 标志
如果 RequiresXboxLive 标志设置为 true，则除非有到 XBOX 网络的活动连接，并且标题清除了 XBOX 服务的身份验证，否则标题不会启动。这确保标题已获取最新的内容更新。如果在标题运行时连接丢失，则标题将被挂起，并随后被终止。 只有”需要互联网”的标题才应将 RequiresXboxLive 标记为 true。请注意，以这种方式标记你的标题并不能保证标题所需的服务已启动并运行。RequiresXboxLive 类似地是 MicrosoftGame.config 文件中Game 下的一个节点。