> ## 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.

# PC 最常见的失败测试用例

> PC 和移动提交最常见失败的 XBOX 认证测试用例,以及每个反复出现问题的原因和补救步骤。

# PC 上最常见的失败测试用例

版本 2.0 - 2024/04/01

## 简介

尽管每款游戏都是独一无二的,但在认证期间许多游戏在几个关键领域遇到挑战。本页涵盖了其中几个关键领域,并提供了在认证期间避免这些问题的提示和策略。

* 要查看 PC 和移动的所有 XBOX 要求 (XR) 测试用例,请转到 [PC 和移动游戏的 XBOX 要求测试用例](/publishing/certification/pc-policy-tests)。

## 最常见的失败 PC 测试用例

| XR/商店政策                                                                                                                      | 测试用例                       | 分布  |
| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------- | --- |
| [10.4.2](https://learn.microsoft.com/windows/apps/publish/store-policies#104-usability)                                      | 应用崩溃或冻结                    | 34% |
| [XR-055:成就](/publishing/certification/pc-policy-tests)                                                                       | 055-01 成就                  | 18% |
| [XR-064:可加入的游戏会话和在线游戏](/publishing/certification/xr/xr-064)                                                                  | 064-02 从同一游戏内加入游戏会话        | 13% |
| [XR-045:XBOX 网络和账户权限](/publishing/certification/xr/xr-045)                                                                   | 045-01 尊重用户权限              | 9%  |
| [XR-052:用户状态和游戏存档位置、漫游和依赖项](/publishing/certification/xr/xr-052)                                                             | 052-05 正确的用户关联             | 4%  |
| [XR-003:游戏完整性](/publishing/certification/xr/xr-003)                                                                          | 游戏完整性                      | 4%  |
| [XR-064:可加入的游戏会话和在线游戏](/publishing/certification/xr/xr-064)                                                                  | 064-02 从游戏外部加入游戏会话         | 3%  |
| [XR-015:管理玩家通信](/publishing/certification/xr/xr-015)                                                                         | 015-01 用户通信                | 3%  |
| [XR-022:官方命名标准](/publishing/certification/pc-terminology)                                                                    | 022-01 官方命名标准              | 3%  |
| [XR-018:用户生成的内容](/publishing/certification/xr/xr-018)                                                                        | 018-01 举报不当内容和 UGC 文本字符串验证 | 3%  |
| [XR-067:维护多人游戏会话状态](/publishing/certification/xr/xr-067)                                                                     | 067-01 维护会话状态              | 2%  |
| [10.1](https://learn.microsoft.com/windows/apps/publish/store-policies#101-distinct-function--value-accurate-representation) | 另一个平台                      | 2%  |
| [XR-052:用户状态和游戏存档位置、漫游和依赖项](/publishing/certification/xr/xr-052)                                                             | 052-05 云存储:漫游              | 2%  |

### 10.4.2 应用崩溃或冻结

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

**指南**

使用最新的图形驱动程序对不同的硬件和显卡配置进行测试。游戏在五种最流行的分辨率(1366 x 768、1440 x 900、1080P、1440P 和 4K)下,在窗口和全屏模式下(如适用)以及使用各种 AMD、Intel 和 Nvidia GPU 进行测试。

**测试场景**

* 从商店安装游戏。测试团队看到从商店安装游戏后的问题,而这些问题在开发者沙盒中侧加载游戏时未见。
* 测试多种分辨率(窗口和全屏)。
* 测试所有屏幕上的随机输入。
* 快速进入和退出游戏菜单。

### 055-01 成就

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

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

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

**常见问题**

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

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

游戏必须尊重所有用户的权限设置,并在发生冲突时显示系统解决 UI。

有关技术指导和最佳实践的详细信息,请参阅 XBOX 服务用户权限的客户端使用文档。

**常见问题**

1. 游戏不尊重用户的权限。
2. 游戏未使用所需的 API 来显示系统解决 UI。

*失败示例*:

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

**指南**

1. 在 XBOX 上,转到"设置"->"通用"->"在线安全和家庭"->"隐私和在线安全"->"XBOX 隐私"。
2. 在 PC 上,转到[隐私和在线安全](https://aka.ms/XboxPrivSettings)以管理权限和隐私设置。
3. 验证 XR-045 中的所有权限。

<Note>
  `XUserCheckPrivilege` 确定用户是否具有特定权限。`XUserResolvePrivilegeWithUiAsync` 显示用户权限所需的解决 UI。这提供了必要的 UI,如果用户没有权限则进行解释或推销。
</Note>

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

游戏必须将进度、已保存的状态、偏好、成就和其他奖励与记录该进度、选择偏好或获得奖励的用户关联。游戏必须避免为不再登录的用户保存状态。此要求的一个关键方面涉及处理游戏处于活动、挂起或终止状态时游戏主要用户发生变化的情况。

* 有关使用 GDK 保存游戏状态的信息,请阅读游戏存档概览。
* 有关使用 GDK 管理游戏状态和保存数据的信息,请阅读 XBOX 游戏生命周期。

### 003-02 游戏完整性

游戏提交必须包括所有客户端代码、提交产物和可下载内容。合作伙伴服务必须可用并正确配置以进行测试和认证。用户必须能够完成所有游戏模式,游戏必须为玩家提供始终可玩的体验。

可玩的体验因游戏而异,但通常意味着没有严重的帧率下降、没有冻结、僵局、造成主要进度阻碍的错误或图形损坏。

**常见问题**

1. 游戏阻止用户在游戏过程中推进。
2. 游戏在最低硬件规格上未按预期运行。
3. 游戏允许用户角色掉出游戏环境或卡住。
4. 游戏必须将进度、已保存的状态、偏好、成就和其他奖励与记录该进度、选择偏好或获得奖励的用户关联。

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

此测试用例验证从游戏外部的可加入性。当用户从游戏外部加入或接受多人游戏体验的邀请时,必须将其带入多人游戏体验。请确保在游戏未运行时验证加入多人游戏体验。

**常见问题**

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

### 015-01 用户通信

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

1. 在控制台上,转到"设置"->"通用"->"在线安全和家庭"->"隐私和在线安全"->"XBOX 隐私"。
2. 在 PC 上,可以在[此处](https://aka.ms/XboxPrivSettings)管理隐私设置。

**常见问题**

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

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

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

### 018-01 举报不当内容和 UGC 文本字符串验证

用户生成的内容 (UGC) 是用户为应用或产品贡献的内容,并且可以被在线状态下的其他用户查看或访问。如果您的产品包含 UGC,您必须:

* 在游戏内或游戏网站上发布并向用户提供用户生成内容的产品服务条款和/或内容准则。
* 提供一种方式,让用户在产品内向开发者举报不当或有害的内容,以供审查和删除/禁用(如果违反内容准则),和/或实现主动检测不当或有害 UGC 的方法(例如,文本过滤)。
* 应 Microsoft 请求,游戏必须删除/禁用 UGC。
* 优雅地处理用户在游戏中无法访问 UGC 的场景。
* 与第三方 mod 平台集成的游戏必须与产品的举报/投诉 API 集成(如果可用),并且如果相应的第三方合同要求,必须审核内容。
* 与第三方 mod 平台集成的游戏必须在内容不是来自开发者时向用户显示免责声明、对话框或视觉提示。

**主动检测有害或不当文本**

使用 [`StringService`](https://learn.microsoft.com/dotnet/api/microsoft.xbox.services.system.stringservice) API 的游戏自动满足主动检测要求(对于文本场景)。游戏应默认利用 StringService API 处理名称和其他简短静态文本字符串。如果游戏具有其他允许较长文本输入的文本场景,或者存在技术或其他限制情况,游戏可以选择通过限制在 XBOX 服务上向另一个玩家显示的一组术语来实现自己的文本过滤变体。请参阅必须作为屏蔽或从 XBOX 服务上非本地玩家中模糊化的最低基线的核心词列表。

**常见问题**

* 游戏未主动检测有害或不当文本。

**指南**

验证所有 UGC 文本字符串都已过滤有害或不当文本。

### 067-01 维护会话状态

在 XBOX 控制台以外的设备上,提供与 XBOX 控制台跨平台多人游戏的游戏必须在 XBOX 多人游戏会话目录 (MPSD) 中维护会话状态信息。如果他们有自己的会话状态功能,他们可以选择使用多人游戏活动最近玩家功能记录玩家交互。

**常见问题**

* 并非所有配置文件都包含在设备的"最近玩家"列表中。
* 在多人游戏中退出的用户不会出现在"最近玩家"中。

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

对于跨平台、设备和/或控制台世代使用相同 TitleID 的游戏,当用户登录到 XBOX 网络时,游戏存档进度必须按以下方式漫游:

* 在 Windows 平台上跨 PC(例如,两个不同的 PC 之间)。
* 在 Windows 平台上的 PC 与 XBOX 控制台平台之间(例如,Windows 和 XBOX Series X|S),不要求游戏存档漫游,但建议支持以增强玩家的体验。

**常见问题**

1. 游戏存档无法在 Windows 平台的第二台 PC 上成功下载。
2. 云中的存档在首次启动时未被游戏识别,并且在没有任何用户交互的情况下,随后在第二台设备上被覆盖。

**指南**

验证游戏存档与创建它们的配置文件相关联,并且当用户登录到 XBOX 时,它们在 2 台 PC 之间漫游。
