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

# Xbox 服务沙盒概述

> 将 XBOX Live 服务配置发布到开发沙盒，了解沙盒 ID、测试帐户，以及如何在 PC 和 XBOX 主机上切换沙盒。

## 为 XBOX 服务开发设置沙盒

在从你的游戏使用 XBOX 服务之前，你必须在 [Partner Center](https://partner.microsoft.com/dashboard) 中在线配置有关标题的信息。此信息包括你标题想要显示的排行榜、玩家可以解锁的成就、匹配配置等功能。

当你对服务配置进行更改时，必须先从 Partner Center 发布这些更改，然后 XBOX 服务才能获取它们。你将发布到*开发沙盒*——一个隔离的环境，你可以在其中处理你的标题而不影响正式版本。

默认情况下，XBOX One（或更高版本）主机和 Windows 10（及更高版本）PC 位于 **RETAIL** 沙盒中。

另请参阅 [高级 XBOX 服务沙盒](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md) 以获取更多信息。

## 本文内容

* [沙盒的优势](#benefits-of-sandboxes)
* [沙盒 ID](#sandbox-ids)
* [哪些数据被沙盒化？](#what-data-is-sandboxed)
* [测试帐户](#test-accounts)
* [使用多个沙盒](#using-multiple-sandboxes)
* [在 PC 上设置你的沙盒](#set-up-your-sandbox-on-pc)
* [在主机上设置你的沙盒](#set-up-your-sandbox-on-console)

***

## 沙盒的优势

开发沙盒提供多种优势：

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

## 沙盒 ID

每个沙盒都有一个唯一的、**区分大小写**的标识符。开发沙盒遵循基于你的发布者名称的命名约定（例如，`XDKS.1` 或 `XLDP.5`）。

这些被称为沙盒 ID，在某些情况下也称为沙盒名称。

> [!NOTE]
>
> 沙盒 ID **区分大小写**。`XDKS.1` 与 `xdks.1` 或 `Xdks.1` 不同。但是，**XblPCSandbox.exe** 工具在 PC 上切换沙盒时会自动更正大小写。所有沙盒 ID 均为大写。始终参考 Partner Center 以获取确切的沙盒 ID。

## 哪些数据被沙盒化？

并非所有 XBOX 服务数据都受沙盒影响。**沙盒化的**数据按沙盒隔离——它仅存在于其创建所在的沙盒中，并且从其他沙盒不可见。**未沙盒化的**数据在所有沙盒（包括 RETAIL）之间全局共享。

| 功能 | 沙盒化？ |
| - | - |
| 成就、排行榜和统计信息 | 是 |
| 服务配置（成就、排行榜、会话模板） | 是 |
| 社交信息（好友、关注者） | 否 |

**关键含义：**

* 在一个沙盒中获得的成就不会转移到另一个沙盒。
* 不同沙盒中的用户无法匹配或一起进行多人游戏。
* 发布到一个沙盒的服务配置在另一个沙盒中不可见。

## 测试帐户

你可以创建 [测试帐户](https://docs.xbox.com/zh-CN/services/xbox-services/develop/test-accounts/live-test-accounts.md) 用于开发和测试，而不是使用你的个人 XBOX 帐户。

这是使用沙盒的推荐选项。

测试帐户：

* **只能**登录到开发沙盒（不能登录到 RETAIL）。
* 可以被授予访问特定沙盒的权限。
* 可以有**过期日期**，你可以在 Partner Center 中检查和管理。
* 可以有**子帐户**，允许你测试社交交互或多人游戏等场景。

> [!TIP]
>
> 如果你在使用测试帐户登录时遇到问题，请参阅 [排查登录和沙盒错误](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md) 部分以获取更多详细信息。

另请参阅 [测试帐户](https://docs.xbox.com/zh-CN/services/xbox-services/develop/test-accounts/live-test-accounts.md) 以获取更多信息。

## 使用多个沙盒

多个沙盒对于更高级的场景很有用：

* **服务配置隔离。** 使用*开发*沙盒进行主动开发，使用*测试*沙盒供你的 QA 团队使用。你发布到*开发*的更改不会影响测试人员看到的内容。
* **多人游戏隔离。** 将开发人员和测试人员保持在单独的沙盒中，以便匹配在测试期间不会混合这两个组。

> [!NOTE]
>
> 如果你在 **XBOX Creators Program** 中，则只能拥有一个沙盒。要创建多个沙盒，你必须在 **Managed Partners 计划** 中。

有关沙盒隔离、产品实例和多组织场景的更多详细信息，请参阅 [高级 XBOX 服务沙盒](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)。

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

以下是使用沙盒时的典型工作流程：

1. **将你的设备切换**到你的开发沙盒。请参阅下面的 [PC](#set-up-your-sandbox-on-pc) 或 [主机](#set-up-your-sandbox-on-console) 说明，具体取决于你计划配置的环境。
2. **发布更改**到你的开发沙盒，同时你对服务配置进行迭代。
3. **共享访问权限**给需要在同一沙盒中工作的团队成员。
4. **切换回 RETAIL**，当你需要在零售环境中测试、更新系统应用程序或玩其他游戏时。

***

## 在 PC 上设置你的沙盒

### 使用 XblPCSandbox.exe 切换你的沙盒（推荐）

**XblPCSandbox.exe** 是随 GDK 附带的命令行工具。这是在 PC 上切换沙盒的推荐方法。

有关如何使用 XblPCSandbox.exe 及其相应参数的更详细信息，请参阅 [XBOX Live PC 沙盒切换器 (XblPCSandbox.exe)](https://docs.xbox.com/zh-CN/tools/tools-services/live-pc-sandbox-switcher.md)

***

## 在主机上设置你的沙盒

本节说明如何将你的 XBOX One（或更高版本）主机切换到开发沙盒，以便你可以使用 XBOX 服务测试你的游戏。

### 使用 XBOX Device Portal

你可以使用 XBOX Device Portal 在你的主机上更改沙盒。为此，请转到你主机上的"Dev Home"并启用它。

之后你可以在 PC 上的 Web 浏览器中输入 IP 地址以连接到你的主机。然后你可以选择 **XBOX Live** 并在其中的文本框中输入沙盒。

### 使用 XBOX Manager

XBOX Manager 适用于 XBOX One 或更高版本的主机。

XBOX Manager 让你可以从 PC 管理主机的某些方面。这包括重启、管理已安装的应用程序和更改你的沙盒。

右键单击你想要更改沙盒的主机，然后转到 **Settings...**

然后你可以在其中输入沙盒。

### 使用 XBOX 主机 UI

如果你想直接从你的 XBOX One（或更高版本）主机更改开发沙盒，你可以转到 **Settings**。然后转到 **Developer Settings**，你会看到更改沙盒的选项。

***

## 下一步是什么？

如果你在切换沙盒时遇到任何问题，请继续 [排查登录和沙盒错误](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)，其中包含引导式诊断过程和错误代码参考。

## 另请参阅

* [高级沙盒概念概述](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [测试帐户](https://docs.xbox.com/zh-CN/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [排查登录和沙盒错误](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [XblPCSandbox.exe 参考](https://docs.xbox.com/zh-CN/tools/tools-services/live-pc-sandbox-switcher.md)
* [XBOX 服务配置概述](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
* [MicrosoftGame.config 概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)


## Related topics

- [沙盒](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [高级 XBOX 服务沙盒](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [XBOX 服务登录故障排除](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [在 Partner Center 设置 XBOX 产品](https://docs.xbox.com/zh-CN/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-product-onboarding-and-configuration.md)
- [Partner Center 的初始配置](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-initial-configuration.md)