> ## 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 要求——稳定性、多人游戏可加入性、成就限制、权限检查和 DLC 处理。

大多数认证失败都围绕一小组反复出现的问题。在提交前解决它们可以大大缩短您的周转时间。

以下分布反映了 Microsoft 发布的最新控制台和 PC 提交数据。

## 控制台:最常见的失败测试

按最近认证周期中所有失败的份额排名:

| 排名 | 测试用例                                                                | 份额  |
| -- | ------------------------------------------------------------------- | --- |
| 1  | [XR-001](/publishing/certification/xr/xr-001) — 001-01 游戏稳定性        | 38% |
| 2  | [XR-003](/publishing/certification/xr/xr-003) — 003-02 游戏完整性        | 14% |
| 3  | [XR-045](/publishing/certification/xr/xr-045) — 045-01 尊重用户权限       | 11% |
| 4  | [XR-064](/publishing/certification/xr/xr-064) — 064-02 从同一游戏内加入游戏会话 | 8%  |
| 5  | [XR-055](/publishing/certification/xr/xr-055) — 055-01 成就           | 7%  |
| 6  | [XR-124](/publishing/certification/xr/xr-124) — 124-01 游戏邀请         | 6%  |
| 7  | [XR-015](/publishing/certification/xr/xr-015) — 015-01 用户通信         | 3%  |
| 8  | [XR-052](/publishing/certification/xr/xr-052) — 052-06 云存储:漫游       | 3%  |
| 9  | [XR-052](/publishing/certification/xr/xr-052) — 052-05 正确的用户关联      | 2%  |
| 10 | [XR-022](/publishing/certification/xr/xr-022) — 022-01 官方命名标准       | 2%  |
| 11 | [XR-001](/publishing/certification/xr/xr-001) — 001-02 挂起后游戏稳定性     | 2%  |
| 12 | [XR-064](/publishing/certification/xr/xr-064) — 064-01 从游戏外部加入游戏会话  | 2%  |

## 指南和最佳实践

### 001-01 游戏稳定性

游戏必须在整个测试期间保持稳定,不得存在任何阻止游戏被测试的问题。

大多数稳定性失败来自:

* 启动游戏时崩溃、挂起或长时间加载屏幕。请参阅 [XR-001](/publishing/certification/xr/xr-001) 以了解预期的时间。
* 多人游戏活动期间(发送/接收邀请、匹配、加入)崩溃。
* 一般游戏过程中崩溃。
* 挂起/恢复期间崩溃或挂起。
* 在接受输入的所有屏幕上,来自用户输入的崩溃或挂起。
* 快速进入和退出游戏菜单时崩溃或挂起。

### 003-02 游戏完整性

游戏在提交时必须功能完整、可测试并满足 XBOX 控制台质量标准。

提交必须包括所有客户端代码、提交产物和 DLC。合作伙伴服务必须可用并正确配置。程序包必须使用当前的[提交验证器](/publishing/game-publishing/concepts/game-package-management)干净地构建,并且必须包含提交验证器日志。

**常见问题**

* 游戏模式无法完成,阻止游戏进度。
* 排行榜未填充。
* 输入模式(控制器、键盘)不工作。
* 玩家进入阻止进度的状态(无法重新装填武器,角色卡住或掉出世界)。

**指南**

* 确保游戏功能完整且可测试。
* 游戏没有主要/游戏破坏性错误。

### 045-01 尊重用户权限

游戏必须尊重每个用户权限设置,并在发生冲突时显示系统解决 UI。请参阅 [XR-045](/publishing/certification/xr/xr-045)。

**常见问题**

* 游戏不尊重儿童和成人账户的权限。
* 游戏未使用所需的 API 来显示系统解决 UI。

**失败示例**

* 当"您可以加入多人游戏"设置为"阻止"时,允许用户加入或接受多人游戏会话邀请。
* 正确阻止加入/接受,但未能显示系统解决 UI。

**指南**

* 在 XBOX 上:**设置 > 通用 > 在线安全和家庭 > 隐私和在线安全 > XBOX 隐私**。
* 在 PC 上:[https://aka.ms/XboxPrivSettings](https://aka.ms/XboxPrivSettings)。
* 使用儿童和成人账户验证每个 XR-045 权限。
* 儿童账户由父母或监护人在 **设置 > 账户 > 家庭设置 > 管理家庭成员** 中管理。

`XUserCheckPrivilege` 确定用户是否具有权限。`XUserResolvePrivilegeWithUiAsync` 显示所需的系统解决 UI,包括在用户没有权限时的任何解释或推销 UI。

### 064-02 从同一游戏内加入游戏会话

验证从同一游戏内的多人游戏可加入性。当用户从同一游戏加入或接受多人游戏体验的邀请时,必须将其带入多人游戏体验。

**常见问题**

* 从同一游戏加入或接受多人游戏体验的邀请不会将用户带入体验。
* 从同一游戏加入或接受受密码保护的多人游戏体验的邀请不会将用户带入体验。

### 055-01 成就

最常见的失败是游戏在满足条件时未能解锁成就。在提交之前,验证每个成就在满足其条件时都能解锁。

### 124-01 游戏邀请

在支持可加入多人游戏会话的任何位置(包括存在跨网络玩家的位置),游戏必须允许玩家**从游戏内**发送游戏邀请。受密码保护的可加入多人游戏体验还必须启用平台加入并允许游戏内邀请。

**常见问题**

* 游戏支持可加入的多人游戏,但不允许玩家从游戏内为这些体验发送游戏邀请。
* 游戏支持受密码保护的可加入多人游戏,但不允许这些体验的游戏内邀请。

**指南**

验证每个可加入的多人游戏体验都允许游戏内邀请。受密码保护的可加入多人游戏还必须允许游戏内邀请。

### 015-01 用户通信

游戏必须检查 XBOX 服务以获取用户的隐私和在线安全权限,当用户的设置不允许时,不得通过 XBOX 传输用户数据或允许通信。

* 在控制台上:**设置 > 通用 > 在线安全和家庭 > 隐私和在线安全 > XBOX 隐私**。
* 在 PC 上:[https://aka.ms/XboxPrivSettings](https://aka.ms/XboxPrivSettings)。

**常见问题**

* 当用户阻止另一个用户时,游戏未阻止来自被阻止用户的所有通信。
* 当"其他人可以通过语音、文本或邀请进行通信"设置为"阻止"时,用户可以通过 XBOX 通过语音/文字进行通信。
* 当同一权限为"阻止"时,用户可以在 XBOX 之外通过语音/文字进行通信。
* 当"其他人可以通过语音、文本或邀请进行通信"设置为"阻止"时,游戏允许用户接收多人游戏邀请。

### 052-06 云存储:漫游

当用户登录到 XBOX 服务时,游戏存档进度必须在类似的设备/平台之间漫游。跨平台世代共享相同 TitleID 的游戏必须跨这些世代漫游存档。在支持时,游戏存档数据必须在 PC 和控制台设备之间成功漫游。

**常见问题**

* 游戏存档无法在同一平台/世代的第二台控制台上下载(例如,XBOX Series S 和 Series X,或 XBOX One 和 One S)。
* 对于跨世代共享相同 TitleID 的控制台游戏(例如,XBOX One 和 Series X|S),存档无法在两者之间漫游。
* 云中的存档在首次启动时未被识别,并且在没有用户交互的情况下在第二台设备上被覆盖。
* 支持时,存档数据无法在 PC 和控制台之间成功漫游。

### 052-05 正确的用户关联

游戏必须将进度、已保存的状态、偏好、成就和其他奖励与记录该进度、选择这些偏好或获得这些奖励的用户关联。游戏不得为不再登录的用户保存状态,并且必须正确处理游戏处于活动、挂起或终止状态时主要用户发生变化的情况。

**常见问题**

* 游戏未正确将存档数据与 XBOX 配置文件关联。
* 用户切换后,游戏错误地关联用户进度、已保存的状态、偏好、成就或其他奖励。
* 用户切换后,新用户的存档进度未保存。
* 新用户在注销后可以更改先前用户的存档数据、状态或配置文件。

### 022-01 官方命名标准

最常见的失败是游戏在文本或图像中引用了竞争平台。确保文本和图像符合[术语列表](/publishing/certification/console-cert-terminology),并且不引用竞争平台(例如,竞争对手的控制器或按钮标注的图像)。

### 001-02 挂起后游戏稳定性

游戏在挂起和恢复时必须保持稳定。

**常见问题**

* 游戏挂起/恢复时崩溃或挂起。
* 游戏挂起时更改用户时崩溃或挂起。
* 在浏览菜单时挂起时崩溃或挂起。
* 在在线比赛期间挂起时崩溃或挂起。

**指南**

在每个菜单、游戏模式和游戏场景(在线和离线)中挂起和恢复游戏。游戏挂起时执行用户切换。

### 064-01 从游戏外部加入游戏会话

验证从游戏外部的可加入性。当用户从游戏外部加入或接受多人游戏体验的邀请时,必须将其带入多人游戏体验。验证在游戏终止和挂起时的加入。

**常见问题**

* 从游戏外部加入或接受邀请不会将用户带入体验。
* 从游戏外部加入或接受受密码保护的多人游戏体验的邀请不会将用户带入体验。
* 在游戏终止或挂起时加入多人游戏体验不会将用户带入体验。

## PC:最常见的失败测试

按最近 PC 认证周期中所有失败的份额排名:

| 排名 | 测试用例                                                                       | 份额  |
| -- | -------------------------------------------------------------------------- | --- |
| 1  | Microsoft Store 政策 10.4.2 — 应用崩溃或冻结                                        | 34% |
| 2  | [XR-055](/publishing/certification/xr/xr-055) — 055-01 成就                  | 18% |
| 3  | [XR-064](/publishing/certification/xr/xr-064) — 064-02 从同一游戏内加入游戏会话        | 13% |
| 4  | [XR-045](/publishing/certification/xr/xr-045) — 045-01 尊重用户权限              | 9%  |
| 5  | [XR-052](/publishing/certification/xr/xr-052) — 052-05 正确的用户关联             | 4%  |
| 6  | [XR-003](/publishing/certification/xr/xr-003) — 游戏完整性                      | 4%  |
| 7  | [XR-064](/publishing/certification/xr/xr-064) — 064-01 从游戏外部加入游戏会话         | 3%  |
| 8  | [XR-015](/publishing/certification/xr/xr-015) — 015-01 用户通信                | 3%  |
| 9  | [XR-022](/publishing/certification/xr/xr-022) — 022-01 官方命名标准              | 3%  |
| 10 | [XR-018](/publishing/certification/xr/xr-018) — 018-01 举报不当内容和 UGC 文本字符串验证 | 3%  |
| 11 | [XR-067](/publishing/certification/xr/xr-067) — 067-01 维护会话状态              | 2%  |
| 12 | Microsoft Store 政策 10.1 — 另一个平台                                            | 2%  |
| 13 | [XR-052](/publishing/certification/xr/xr-052) — 052-06 云存储:漫游              | 2%  |

### 10.4.2 应用崩溃或冻结(PC 最常见失败)

游戏在启动时或游戏过程中崩溃或挂起。

**捕获它的测试场景:**

* 从商店安装游戏(不仅仅是从开发沙盒侧加载——这两条路径有时行为不同)。
* 测试多种分辨率(窗口和全屏):1366×768、1440×900、1080P、1440P、4K。
* 测试所有屏幕上的随机输入。
* 快速进入和退出游戏菜单。
* 使用 AMD、Intel 和 Nvidia GPU 以及当前的图形驱动程序进行测试。

### PC 特定错误

* **PC 上未应用 XR-018 UGC 过滤** — 就像在控制台上一样,在 PC 上重用 [`StringService`](/reference/live/xsapi-c/atoc-xsapi-c) API。
* **提交前沙盒未切换回零售** — 在开发沙盒中测试的包可能无法通过认证。
* **`makepkg` 打包问题** — 缺少依赖、错误的内容 ID、没有 `Submission Validator` 日志。
* **跨网络数据使用** — 请参阅 [XR-007 (PC)](/publishing/certification/xr/xr-007-pc);在隐私政策中声明跨网络数据流。

## 提交前清单

在提交之前:

1. 对最终包运行[提交验证器](/publishing/game-publishing/concepts/packages-overview);解决每个失败。
2. 使用自动化浸泡(通过 PLM 循环 8-12 小时)扫查 XR-001。
3. 通过在多人游戏比赛中断掉网络并观察重新连接行为来运行 XR-074。
4. 通过登录儿童账户并确认功能正确门控来抽查 XR-045。
5. 通过在每个支持的控制台 SKU 上测试来验证 XR-130。
6. 在最终认证之前通过 [MGATS](/build/game-principles/accessibility/mgats) 运行可访问性(XR 相邻)检查。

## 另请参阅

* [XBOX 要求](/publishing/certification/xbox-requirements)
* [失败模式分析](/publishing/certification/xr-fma)
* [认证](/publishing/certification/overview)
* [发布前测试](/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-prerelease)


## Related topics

- [PC 最常见的失败测试用例](/zh-CN/publishing/certification/pc-top-failing.md)
- [PC 和移动认证要求以及最常见的失败](/zh-CN/publishing/certification/pc-certification.md)
- [XR 失败模式分析](/zh-CN/publishing/certification/xr-fma.md)
- [XBOX 要求 (XR) 认证参考](/zh-CN/publishing/certification/xbox-requirements.md)
- [PC 和移动游戏的 XBOX 要求测试用例](/zh-CN/publishing/certification/pc-policy-tests.md)
