> ## 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 服务沙盒概述

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

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

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

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

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

另请参阅 [高级 XBOX 服务沙盒](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes) 以获取更多信息。

## 本文内容

* [沙盒的优势](#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，在某些情况下也称为沙盒名称。

<Info>沙盒 ID **区分大小写**。`XDKS.1` 与 `xdks.1` 或 `Xdks.1` 不同。但是，**XblPCSandbox.exe** 工具在 PC 上切换沙盒时会自动更正大小写。所有沙盒 ID 均为大写。始终参考合作伙伴中心以获取确切的沙盒 ID。</Info>

## 哪些数据被沙盒化？

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

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

**关键含义：**

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

## 测试帐户

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

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

测试帐户：

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

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

另请参阅 [测试帐户](/services/xbox-services/develop/test-accounts/live-test-accounts) 以获取更多信息。

## 使用多个沙盒

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

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

<Note>如果你在 **XBOX Creators 计划** 中，则只能拥有一个沙盒。要创建多个沙盒，你必须在 **Managed Partners 计划** 中。</Note>

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

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

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

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)](/tools/tools-services/live-pc-sandbox-switcher)

***

## 在控制台上设置你的沙盒

本节说明如何将你的 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**，你会看到更改沙盒的选项。

***

## 下一步是什么？

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

## 另请参阅

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


## Related topics

- [沙盒](/zh-CN/services/xbox-services/fundamentals/sandboxes/live-sandboxes-nav.md)
- [XBOX 服务登录故障排除](/zh-CN/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [在合作伙伴中心设置 XBOX 产品](/zh-CN/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-product-onboarding-and-configuration.md)
- [合作伙伴中心的初始配置](/zh-CN/publishing/xstore-commerce/xstore-initial-configuration.md)
- [启用授权测试](/zh-CN/publishing/xstore-commerce/xstore-licensing-setup.md)