> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 沙盒

> 了解 XBOX 沙盒如何为开发和测试隔离内容，包括在沙盒中创建产品以及使用 MSA 控制访问权限。

在沙盒中创建 XBOX 游戏。此方法称为\_内容隔离\_。当你在沙盒中创建产品时，可以在只有选定用户才能访问的隔离环境中对其进行测试。访问权限仅限于有权登录该沙盒的 Microsoft 帐户 (MSA)。

沙盒对于 XBOX 游戏开发至关重要。它们提供了一个环境来测试 XBOX 服务（例如多人游戏和成就）以及 Microsoft Store 体验。你可以测试游戏安装体验，并查看你的商店产品详细信息页 (PDP)，包括 **商店列表**、**属性** 和 **游戏元数据**。

某些产品类型会自动支持沙盒。对于其他产品类型（例如游戏捆绑包），在创建产品时选择 **在沙盒中创建此产品**。

如果你的产品满足以下条件，则必须在沙盒中创建它：

* 使用 XBOX 服务。
* 是具有单独 Microsoft Store 列表的加载项。
* 是其父产品位于沙盒中的加载项。
* 是包含使用 XBOX 服务的产品的捆绑包。
* 包含一个或多个 XVC 包。

## 分支和沙盒之间的差异

分支和沙盒是不同的概念，你通常在开发和发布期间一起使用它们。在合作伙伴中心内，每个受支持的模块都有自己的分支。**Main** 分支是默认分支。当你创建产品时，它会自动为所有模块显示。你可以在每个受支持的模块中创建额外的分支：**包**、**商店列表** 和 **定价和可用性**。每个分支对该模块都是唯一的。例如：

* **包** 中的测试分支独立于 **商店列表** 中的 **测试** 分支。
* 你在一个模块的分支中所做的更改不会自动反映在其他模块中。

使用分支来配置和测试在不同沙盒中使用的不同设置。例如，若要在不覆盖已发布配置的情况下测试价格更改，请在 **定价和可用性** 中创建名为 **新定价** 的新分支，从 **Main** 分支导入当前设置，然后在新分支中进行所需的更改。当你准备好发布这些更改时，可以将它们导入到 **Main** 分支中。

有关详细信息，请参见[分支](/publishing/game-publishing/concepts/branches)。

## 沙盒类型

有两种类型的沙盒：**全局** 和 **开发**。

* 全局沙盒包括 **RETAIL**（玩家在其中访问游戏和服务）以及用于认证测试的其他沙盒。
* 开发沙盒特定于你的合作伙伴中心帐户。你可以使用这些沙盒来开发和测试你的产品。

### 隔离沙盒和共享开发沙盒

你可以将开发沙盒配置为 **隔离** 或 **共享**。

* 你帐户中的任何产品都可以使用 **共享** 沙盒。
* 只有你指定的产品才能使用 **隔离** 沙盒。

如果将沙盒配置为"隔离"，则必须选择可以发布到该沙盒的产品。加载项从其父产品继承权限。若要更新产品列表，请在 **沙盒** 页面上选择该沙盒，然后在后续页面上选择 **管理已批准的产品**。你还可以随时在 **隔离** 和 **共享** 之间更改沙盒的类型。

## 沙盒标识符

每个合作伙伴中心帐户可以访问 100 个开发沙盒。每个开发沙盒都有一个由两部分组成的唯一标识符：合作伙伴中心帐户独有的前缀（例如 ABCDEF）和 0 到 99 之间的数值。这两部分共同构成沙盒 ID，例如 **ABCDEF.1**。

全局沙盒的命名不带数值，例如 **RETAIL**。

通常有：

* 一个或多个用于开发的沙盒。例如，每个开发团队的沙盒。
* 一个或多个用于 QA 的沙盒。例如，一个用于内部 QA 团队的沙盒，以及每个与你合作的外部 QA 团队的沙盒。
* 一个用于认证暂存的沙盒，作为准备和测试提交进行认证的候选发布版本的位置。

这种结构使你的团队能够保持灵活性并专注于产品的各自领域。

## 创建和管理开发沙盒

当你在沙盒中创建新游戏时，在 **游戏设置** 页面中选择主开发沙盒。如果没有创建任何沙盒，请选择 **管理沙盒** 以访问 **沙盒** 页面并创建你的第一个开发沙盒。根据需要通过返回 **沙盒** 页面创建新的开发沙盒。可从 **应用和游戏** 仪表板以及你产品的设置页面访问该页面。

有关详细信息，请访问：[如何创建和管理开发沙盒](/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes)。

## 创建和管理测试帐户

必须先使用授权的 MSA 登录沙盒，然后才能访问该沙盒中发布的任何产品或 XBOX 服务。全局沙盒（如 **RETAIL**）使用标准 MSA。开发沙盒使用你在合作伙伴中心中创建的 XBOX 测试帐户。你可以控制每个测试帐户可以访问的沙盒。若要创建和配置测试帐户，请转到 **应用和游戏** 仪表板，然后选择 **XBOX 测试帐户**。在此，你可以：

* 创建批量测试帐户。
* 查看和修改测试帐户批次的属性，例如帐户类型和沙盒访问权限。
* 查看测试帐户批次的详细信息，例如批次中每个测试帐户的电子邮件、玩家标签、XUID 和权限。
* 删除批量测试帐户。

有关详细信息，请参见[如何创建和管理 XBOX 测试帐户](/publishing/game-publishing/how-to/how-to-create-and-manage-test-accounts)。

## 将产品发布到沙盒

将产品发布到沙盒以查看或测试它。

### 发布 XBOX 服务

如果你只需要为游戏发布 XBOX 服务，请转到 **游戏玩法设置**，选择 **发布**，然后选择在何处发布设置。

### 发布产品

若要发布产品，请使用 **审阅并发布** 选项。你可以从产品的 **概览** 页面访问它。在 **审阅并发布** 页面上，在 **发布到** 下拉列表中选择预期目标。如果选择 **RETAIL**，则只能从产品的 **Main** 分支发布。如果选择开发沙盒，则选择 **发布来源**。如果产品已发布到此沙盒，可以选择 **RETAIL**，或选择 **自定义**。选择 **自定义** 可让你为产品的每个模块选择具有预期配置的分支。

在选择 **发布** 后，通过检查 **概览** 页面上显示的信息来监控发布状态。你可以选择 **历史记录** 以查看以前的发布详细信息。

<Note>
  你可以发布到的唯一全局沙盒是 RETAIL。若要提交认证更新，请使用 **认证** 工作流。
</Note>

## 在沙盒中测试产品

发布到沙盒后，使用授权帐户登录该沙盒。如果只发布了 XBOX 服务，可以使用通过游戏开发套件 (GDK) 工具部署到设备的包连接到服务。如果发布了完整的产品，则其在沙盒中 Microsoft Store 内的可用性取决于 **定价和可用性** 模块中配置的 **日程安排**。有关详细信息，请参见[配置产品在 Microsoft Store 中可见并可购买](/publishing/game-publishing/how-to/how-to-visible-release)。

如果你将产品的 **定价和可用性** 模块配置为具有将来的 **发布** 日期或 **可在 Microsoft Store 中发现** 日期，则无法使用 Microsoft Store 中的搜索功能找到它。你可以使用合作伙伴中心内产品的 **设置** 页面上找到的商店协议链接找到该产品。

<Note>
  如果在产品的 **定价和可用性** 模块的 **可见性** 部分中配置了[专用受众](/publishing/game-publishing/concepts/availability/visibility-audiences)，这不会影响产品在开发沙盒中的可见性。**专用受众** 仅适用于发布到 RETAIL 沙盒的产品。
</Note>

## 管理用户的沙盒级权限

[将用户添加到合作伙伴中心帐户](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-users-groups-azure-ad-applications)时，你可以[授予自定义权限](https://learn.microsoft.com/windows/apps/publish/partner-center/overview-of-roles-and-permissions-for-account-users)。对于 **测试帐户** 和 **XBOX 设备** 帐户级权限，你可以选择用户具有这些权限的特定沙盒。为此，请选择该权限，然后选择 **所有沙盒** 或一个或多个单独的沙盒。选中 **所有沙盒** 会将权限授予所有现有沙盒和将来创建的任何沙盒。若要将权限授予所有当前沙盒但不包括将来的沙盒，请清除 **所有沙盒**，然后单独选择每个沙盒。

## 另请参见

* [如何创建和管理开发沙盒](/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes)
* [分支](/publishing/game-publishing/concepts/branches)
* [审阅并发布](/publishing/game-publishing/concepts/modular-submission)
* [管理帐户用户](https://learn.microsoft.com/windows/apps/publish/partner-center/manage-account-users)


## Related topics

- [沙盒](/zh-CN/services/xbox-services/fundamentals/sandboxes/index.md)
- [XBOX 服务沙盒概述](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [创建和管理开发沙盒](/zh-CN/publishing/game-publishing/how-to/how-to-create-and-manage-sandboxes.md)
- [登录和沙盒错误故障排除](/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [PC 沙盒切换器 (XblPCSandbox.exe)](/zh-CN/tools/tools-services/live-pc-sandbox-switcher.md)