> ## 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 服务配置,从完整 XBOX 服务和成就到禁令和 RETAIL 发布。

游戏测试在 RETAIL 沙盒(即玩家使用的实时环境)中运行。当版本使用 XBOX 登录、成就、状态或其他 XBOX 服务时,游戏需要完整 XBOX 服务,并且其 XBOX 服务配置必须发布到 RETAIL。这样,测试人员使用的就是与已发布游戏的玩家相同的实时 XBOX 服务。请参阅
[XBOX 服务与 Playtest](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#xbox-services-and-playtest)。

在[创建游戏测试](https://docs.xbox.com/zh-CN/tools/xbox-cli/first-playtest.md)之前,执行一次以下步骤:

1. [获取完整 XBOX 服务](#1-get-full-xbox-services)。
2. [选择成就的处理方式](#2-choose-what-happens-to-achievements)。
3. [设置禁令](#3-set-the-embargo)。
4. [将配置发布到 RETAIL](#4-publish-the-configuration-to-retail)。

示例使用 XBOX 游戏 ID `1234ABCD` 和开发沙盒 `XDKS.1`,该沙盒包含测试版本时所用的配置。

## 1. 获取完整 XBOX 服务

新游戏开始时 XBOX 服务处于禁用状态。受限 XBOX 服务仅在开发沙盒中工作,并且不包括成就或统计信息。在你的游戏概念获得批准后,将游戏的 Store ID 发送给你的 XBOX 代表,并请求他们加入该产品。然后,在 Partner Center 中游戏的**游戏设置**页面上选择 **Enable full XBOX services**。请参阅
[启用 XBOX 服务](https://docs.xbox.com/publishing/game-publishing/concepts/xbox-services.md#enable-xbox-services)。

在此之前,包含成就的配置无法通过验证:

```text theme={null}
XblLimited products do not support achievements or stats2013/stats2015 configuration.
```

## 2. 选择成就的处理方式

发布到 RETAIL 的成就是永久性的。你仍可以更改其名称、说明和图稿,但无法删除它们,也无法更改其解锁规则或玩家分数。发布到 RETAIL 的统计信息同样无法删除。游戏的成就系统(游戏管理或基于事件)在首次 RETAIL 发布时即已固定。在该发布之前,请选择以下选项之一:

| 选项 | 适用情况 | 方法 |
| - | - | - |
| 发布最终成就 | 成就已最终确定。 | 照常发布。对于尚未发布的游戏,下一步中的禁令会对其他玩家隐藏这些成就。 |
| 请求验证覆盖 | 需要在游戏测试期间更改成就设计。 | 向你的 XBOX 代表请求开发期间的验证覆盖。在提交游戏进行认证之前将其删除。 |

适用于 PC 或 XBOX 主机的游戏不能跳过将其成就发布到 RETAIL。在 Partner
Center 中,如果对 **Publish Achievements to Retail?** 回答**否**,将失败并显示:

```text theme={null}
The specified Platform:Windows can be used only when game is configured to Publish Achievements.
```

所有已发布的成就都必须满足 XBOX 关于成就和玩家分数的要求。请参阅
[成就](https://docs.xbox.com/publishing/game-publishing/concepts/playtest-preview.md#achievements)。

## 3. 设置禁令

在你选择的日期之前,禁令会在 XBOX 应用和主机 UI 中向玩家隐藏游戏的成就、状态和其他 XBOX 服务数据,并阻止屏幕截图和视频捕获。
如果没有禁令,游戏测试之外的玩家可以看到游戏的配置。

仅为尚未发布的游戏设置禁令。对于已发布的游戏,新的禁令会向其玩家隐藏其 XBOX 服务数据。

在 Partner Center 中,打开 **XBOX 服务** > **XBOX 设置**,转到**禁令日期**,然后设置一个晚于游戏测试结束时间且不晚于游戏公开发布时间的 UTC 日期和时间。
如果游戏测试持续到发布之后,请在发布时结束禁令。如果测试人员会相互邀请加入多人游戏会话,请选择
**在禁令期间允许多人游戏邀请**。
请参阅[配置禁令日期](https://docs.xbox.com/publishing/game-publishing/tutorial-xbox-managed/how-to-configure-xbox-services.md#configure-embargo-date)。

禁令是游戏范围的设置,存储在 `ALL` 沙盒中,并适用于每个沙盒。
若要检查它,请下载 `ALL`:

```bash theme={null}
xbox xbl config download --title-id 1234ABCD --sandbox-id ALL --view draft --dest xbox-config-all
```

`productdeveloper.xml` 包含禁令:

```xml theme={null}
<XboxLiveEmbargoDate>2027-03-01T17:00:00Z</XboxLiveEmbargoDate>
<EmbargoInvitesEnabled>true</EmbargoInvitesEnabled>
```

禁令会在游戏范围的配置发布后生效。如果 Partner Center 显示未发布的更改,请在 Partner Center 中发布,或使用 `--sandbox-id HIDDEN` 发布:

> [!WARNING]
>
> 游戏范围的发布会发布所有待处理的游戏范围更改,而不仅仅是禁令,并且这些更改也会进入 RETAIL。请先查看待处理的更改。

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --sandbox-id HIDDEN
```

该命令在发布之前会进行询问。请参阅
[源选择](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/xbl.md#source-selection)。

发布是异步进行的。在发布到 RETAIL 之前,请检查 `lastPublish` 是否显示游戏范围的发布已成功:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id HIDDEN
```

## 4. 将配置发布到 RETAIL

将开发沙盒的配置直接发布到 RETAIL。RETAIL 不需要先发布到 CERT,也不需要认证。

> [!WARNING]
>
> RETAIL 发布一完成即对玩家生效,并且已发布的成就无法删除。请参阅[安全性和破坏性操作](https://docs.xbox.com/zh-CN/tools/xbox-cli/safety.md)。

先进行验证。验证不会更改任何内容,并会列出发布所添加的成就:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD \
  --source-sandbox-id XDKS.1 --sandbox-id RETAIL --validate-only
```

如果验证显示 `FirstRetailPublishWithoutEffectiveEmbargo` 警告,则表示尚无生效的禁令。请完成[步骤 3](#3-set-the-embargo),包括游戏范围的发布。

从 `XDKS.1` 发布会替换 RETAIL 中同名的工作文档以及 RETAIL 的全局游戏存储文件,并删除仅 RETAIL 拥有的所有文件。请参阅
[跨沙盒发布](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/xbl.md#cross-sandbox-publishing-replaces-global-title-storage-files)。

验证没有问题后,即可发布。该命令会描述此次发布并先进行询问:

```bash theme={null}
xbox xbl config publish --title-id 1234ABCD --source-sandbox-id XDKS.1 --sandbox-id RETAIL
```

检查 `lastPublish`,直到发布完成:

```bash theme={null}
xbox xbl config status --title-id 1234ABCD --sandbox-id RETAIL
```

然后[创建并发布游戏测试](https://docs.xbox.com/zh-CN/tools/xbox-cli/first-playtest.md)。


## Related topics

- [你的第一个游戏测试](https://docs.xbox.com/zh-CN/tools/xbox-cli/first-playtest.md)
- [XBOX CLI](https://docs.xbox.com/zh-CN/tools/xbox-cli/index.md)
- [Playtest](https://docs.xbox.com/zh-CN/tools/xbox-cli/commands/playtest.md)
- [配置 XBOX 服务](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/xbox-services.md)
- [使用 Playtest](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/playtest-preview.md)
