Skip to main content

为 XBOX 服务开发设置沙盒

在从你的游戏使用 XBOX 服务之前,你必须在 合作伙伴中心 中在线配置有关标题的信息。此信息包括你标题想要显示的排行榜、玩家可以解锁的成就、匹配配置等功能。 当你对服务配置进行更改时,必须先从合作伙伴中心发布这些更改,然后 XBOX 服务才能获取它们。你将发布到开发沙盒——一个隔离的环境,你可以在其中处理你的标题而不影响正式版本。 默认情况下,XBOX One(或更高版本)控制台和 Windows 10(及更高版本)PC 位于 RETAIL 沙盒中。 另请参阅 高级 XBOX 服务沙盒 以获取更多信息。

本文内容


沙盒的优势

开发沙盒提供多种优势:
  • 安全迭代。 你可以对标题的服务配置进行更改,而不会影响当前可用的版本。
  • 工具访问。 出于安全原因,某些工具仅在开发沙盒中工作。
  • 分支你的配置。 团队中的开发人员可以在单独的沙盒中测试服务配置更改,而不会相互影响。
  • 隐私。 其他发布者未经授予对你沙盒的访问权限就无法看到你正在做什么。

沙盒 ID

每个沙盒都有一个唯一的、区分大小写的标识符。开发沙盒遵循基于你的发布者名称的命名约定(例如,XDKS.1XLDP.5)。 这些被称为沙盒 ID,在某些情况下也称为沙盒名称。
沙盒 ID 区分大小写XDKS.1xdks.1Xdks.1 不同。但是,XblPCSandbox.exe 工具在 PC 上切换沙盒时会自动更正大小写。所有沙盒 ID 均为大写。始终参考合作伙伴中心以获取确切的沙盒 ID。

哪些数据被沙盒化?

并非所有 XBOX 服务数据都受沙盒影响。沙盒化的数据按沙盒隔离——它仅存在于其创建所在的沙盒中,并且从其他沙盒不可见。未沙盒化的数据在所有沙盒(包括 RETAIL)之间全局共享。 关键含义:
  • 在一个沙盒中获得的成就不会转移到另一个沙盒。
  • 不同沙盒中的用户无法匹配或一起进行多人游戏。
  • 发布到一个沙盒的服务配置在另一个沙盒中不可见。

测试帐户

你可以创建 测试帐户 用于开发和测试,而不是使用你的个人 XBOX 帐户。 这是使用沙盒的推荐选项。 测试帐户:
  • 只能登录到开发沙盒(不能登录到 RETAIL)。
  • 可以被授予访问特定沙盒的权限。
  • 可以有过期日期,你可以在合作伙伴中心中检查和管理。
  • 可以有子帐户,允许你测试社交交互或多人游戏等场景。
如果你在使用测试帐户登录时遇到问题,请参阅 排查登录和沙盒错误 部分以获取更多详细信息。
另请参阅 测试帐户 以获取更多信息。

使用多个沙盒

多个沙盒对于更高级的场景很有用:
  • 服务配置隔离。 使用开发沙盒进行主动开发,使用测试沙盒供你的 QA 团队使用。你发布到开发的更改不会影响测试人员看到的内容。
  • 多人游戏隔离。 将开发人员和测试人员保持在单独的沙盒中,以便匹配在测试期间不会混合这两个组。
如果你在 XBOX Creators 计划 中,则只能拥有一个沙盒。要创建多个沙盒,你必须在 Managed Partners 计划 中。
有关沙盒隔离、产品实例和多组织场景的更多详细信息,请参阅 高级 XBOX 服务沙盒

沙盒如何适应你的工作流程

以下是使用沙盒时的典型工作流程:
  1. 将你的设备切换到你的开发沙盒。请参阅下面的 PC控制台 说明,具体取决于你计划配置的环境。
  2. 发布更改到你的开发沙盒,同时你对服务配置进行迭代。
  3. 共享访问权限给需要在同一沙盒中工作的团队成员。
  4. 切换回 RETAIL,当你需要在零售环境中测试、更新系统应用程序或玩其他游戏时。

在 PC 上设置你的沙盒

使用 XblPCSandbox.exe 切换你的沙盒(推荐)

XblPCSandbox.exe 是随 GDK 附带的命令行工具。这是在 PC 上切换沙盒的推荐方法。 有关如何使用 XblPCSandbox.exe 及其相应参数的更详细信息,请参阅 XBOX Live PC 沙盒切换器 (XblPCSandbox.exe)

在控制台上设置你的沙盒

本节说明如何将你的 XBOX One(或更高版本)控制台切换到开发沙盒,以便你可以使用 XBOX 服务测试你的游戏。

使用 XBOX 设备门户

你可以使用 XBOX 设备门户在你的控制台上更改沙盒。为此,请转到你控制台上的”Dev Home”并启用它。 之后你可以在 PC 上的 Web 浏览器中输入 IP 地址以连接到你的控制台。然后你可以选择 XBOX Live 并在其中的文本框中输入沙盒。

使用 XBOX Manager

XBOX Manager 适用于 XBOX One 或更高版本的控制台。 XBOX Manager 让你可以从 PC 管理控制台的某些方面。这包括重启、管理已安装的应用程序和更改你的沙盒。 右键单击你想要更改沙盒的控制台,然后转到 Settings… 然后你可以在其中输入沙盒。

使用 XBOX 控制台 UI

如果你想直接从你的 XBOX One(或更高版本)控制台更改开发沙盒,你可以转到 Settings。然后转到 Developer Settings,你会看到更改沙盒的选项。

下一步是什么?

如果你在切换沙盒时遇到任何问题,请继续 排查登录和沙盒错误,其中包含引导式诊断过程和错误代码参考。

另请参阅

最后修改于 2026年8月25日