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

# 认证 BVT 指南

> 查看使用 XBOX services 的主机游戏和 PC 游戏常见的生成验证测试 (BVT) 失败，例如未修复的 CFR、稳定性问题和合作伙伴服务不可用。

集成 XBOX services 的游戏必须遵守一系列 [XBOX Requirements](https://docs.xbox.com/zh-CN/publishing/certification/xbox-requirements.md) (XR)。PC 游戏还必须遵守 [Microsoft Store 政策](https://learn.microsoft.com/windows/apps/publish/store-policies)。

这些要求的一个子集是[生成验证测试](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#BVTs) (BVT)，它是一套用于确定游戏是否已准备好进行完整认证测试的测试。所有游戏都必须先通过 BVT，然后才能进入完整认证测试。未通过 BVT 的游戏必须先修复所有失败问题，然后才能重新提交认证。

## 常见的 BVT 失败

以下是主机和 PC 上常见 BVT 失败的列表。如果不同设备之间存在差异，会在相应位置特别说明。

### 未修复的重新提交条件 (CFR)

游戏未通过 BVT 的主要原因之一，是新版本未修复之前记录的所有重新提交条件 (CFR) 或 BVT 失败问题。测试团队会先验证上一轮测试中记录的每个 CFR 均已修复，然后才会安排该游戏进行完整测试。有关该测试，请参阅 [BVT-09 Conditions for Resubmission](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-09-conditions-for-resubmission)。

**指导：**\
在提交新版本之前，请确保认证报告中的所有 CFR 以及之前的所有 BVT 失败问题均已修复。

### 游戏稳定性

游戏在测试期间必须保持稳定，并且不得存在任何阻碍测试的问题。BVT 团队会验证所有菜单均可访问，并且所有游戏模式均可测试。有关该测试，请参阅 [BVT-01 Build Stability](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-01-build-stability)。

**指导：**\
在所有受支持的设备类型和硬件配置上测试游戏，在 PC 上请使用最新的图形驱动程序。查看 [XR-001：游戏稳定性](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#XR001)的测试用例，并重点关注每个测试用例的通过和失败示例。

BVT 期间发现的稳定性问题示例：

* 启动游戏时崩溃、挂起或加载屏幕时间过长。
* 在多人游戏活动（例如发送和接收游戏邀请、匹配和加入方案）期间崩溃。
* 在常规游戏过程中崩溃。
* 在主机上测试暂停和恢复方案时崩溃或挂起。
* 在所有接受用户输入的屏幕上测试用户输入时崩溃或挂起。
* 快速进入和退出所有游戏菜单时崩溃或挂起。

**PC 上的其他测试方案：**

* 从商店安装游戏。测试团队曾在从商店安装游戏后发现一些问题，而这些问题在开发人员沙盒中旁加载游戏时不会出现。
* 测试多种分辨率（窗口模式和全屏模式）。

### 未安装所需的依赖项 (PC)

从商店安装游戏时，所需的依赖项未安装在全新的 PC 上。例如，在全新的 PC 上安装游戏后，游戏无法启动并显示以下错误：*The code execution cannot proceed because MSVCP100.dll was not found*。

**指导：**\
在全新安装的 Windows 上进行测试，并确保已从设备中删除所有包依赖项。将游戏发布到商店，然后安装并验证所有游戏依赖项均已安装。将游戏所需的任何依赖项包含在安装目录中；如果商店未安装这些依赖项，请在首次启动时提示用户安装。

参考：[Framework Package Dependencies](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/packaging-framework-packages.md)

### 双重身份验证 (PC)

当之前从未启动过该游戏的配置文件登录时，系统未向用户显示明确同意对话框。启动游戏后，在进入任何游戏玩法或菜单之前，游戏会无限期停留在加载屏幕上。

**指导：**\
使用启用了双重身份验证的开发人员帐户测试登录。在 Partner Center 中创建开发人员帐户时，有一个选择双重身份验证的选项。游戏很可能只调用了 `XUserAddAsync(AddDefaultUserSilently)`，并假定始终存在用户。游戏应使用 `XUserAddAsync(AddDefaultUserAllowingUI)`，并包含处理任何潜在错误情况的代码。GDK 中提供了演示如何使用此方法的示例。这样，当没有已登录的用户、缺少同意或需要解决其他身份验证问题时，就可以显示 UI。

参考：[XUserAddAsync GDK 文档](https://docs.xbox.com/zh-CN/reference/system/xuser/functions/xuseraddasync.md)

### 合作伙伴托管的服务

当认证团队收到提交时，游戏所需的合作伙伴服务（例如多人游戏服务）必须正常运行。BVT 团队会在安排游戏进行完整测试之前验证这些服务。这些服务必须在整轮测试期间保持正常运行。有关该测试，请参阅 [BVT-12 Partner-Hosted Services](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-12-partner-hosted-services)。

**指导：**\
验证游戏所需的所有合作伙伴服务在你提交认证时以及整轮测试期间均正常运行。

### Microsoft Store 可用性和 XBOX services 游戏玩法设置

在 BVT 期间，游戏将从 CERT 和 CERT.DEBUG 沙盒中的商店下载。在 Partner Center 中完成到 CERT 沙盒的发布后，请同时更新 CERT.DEBUG 沙盒中的 XBOX services 游戏玩法设置。这将有助于确保在获取和设置游戏以进行测试时不会出现延迟。有关该测试，请参阅 [BVT-08 XBOX Store Availability](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-08-xbox-store-availability)。

**更新 CERT.DEBUG 中的 XBOX services 游戏玩法设置**\
如果这是你的首次提交，或者你在上次提交后更新了 XBOX services 游戏玩法设置，请手动将这些设置发布到 CERT.DEBUG 沙盒。

**指导：**

1. 在 Partner Center 中，转到你的产品的 XBOX services - Gameplay settings 页面。选择你在 Certify 工作流中为包选择的源沙盒。
2. 选择 **Review and Publish**，将你的 XBOX services 游戏玩法设置发布到 CERT.DEBUG 目标沙盒。

### 多人游戏

支持多人游戏体验的游戏必须允许用户成功开始、推进并完成多人游戏会话。BVT 团队会尝试匹配开始会话所需的最少用户数，并完成结束一场比赛所需的最少目标。有关该测试，请参阅 [BVT-02 Matchmaking](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-02-matchmaking)。

如果游戏支持多人游戏，但不支持匹配体验，BVT 团队将使用系统和游戏内的邀请和加入功能，让所需的最少用户数进入一场比赛。

**指导：**\
在提交认证之前，请确保所有受支持的多人游戏功能均已完成、正常运行且可测试。

如果游戏支持可加入的多人游戏体验，BVT 团队还会验证系统加入和邀请是否按预期工作。游戏必须允许用户**在游戏内**发送加入这些可加入体验的邀请。以下各节介绍了最常见的问题。

#### 可加入的游戏会话

提供可加入游戏会话的游戏必须通过 XBOX 外壳界面启用可加入性。BVT 团队会验证在游戏内和游戏外（游戏已终止或已暂停时）加入会话的情况。

失败示例包括：

* 用户无法从系统界面加入公共大厅。
* 用户从系统界面加入时，游戏未将其转入会话。

**指导：**\
验证用户能够通过 XBOX 外壳界面加入多人游戏体验，包括在游戏正在运行、已终止和已暂停时。验证每个可加入的多人游戏体验都允许用户从系统界面加入。

#### 游戏邀请

支持可加入多人游戏体验的游戏必须允许玩家使用 XBOX 网络平台\_在游戏内\_向其他 XBOX 网络用户发送游戏邀请，包括存在跨网络玩家的方案。

失败示例包括：

* 游戏支持可加入的多人游戏体验，但不支持在游戏内发送游戏邀请。
* 用户接受游戏邀请时，游戏未将其转入预期的多人游戏体验。

**指导：**\
对于支持可加入多人游戏体验的游戏，验证\_游戏内\_存在邀请选项。

### 可下载内容 (DLC)

支持耐用型和消耗型加载项的游戏必须针对每种受支持的可下载内容 (DLC) 类型，至少提交一个产品与游戏一起测试。例如，一款支持赛道包、车辆包和虚拟货币包的赛车游戏，需要至少认证一个赛道加载项、一个车辆加载项和一个虚拟货币包加载项。必须能够通过搜索或深层链接在商店中找到 DLC 包，BVT 团队会检查 DLC 的安装情况以及其在游戏中的存在情况。有关该测试，请参阅 [BVT-03 DLC](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-03-dlc)。

**指导：**\
在提交之前，将每种受支持的 DLC 类型至少发布一个产品到 CERT 和 CERT.DEBUG 沙盒中，以便认证团队下载。

### 成就无法解锁 (PC)

满足条件后，游戏未解锁所有成就。

**指导：**\
验证满足条件后所有成就均会解锁。

### Submission Validator 和生成 ID 不匹配

BVT 团队会验证 [Submission Validator](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/subval/submissionvalidator.md) 日志中的 `<BuildId>` 与提交认证的包的 `<BuildId>` 是否匹配。请检查日志中是否存在任何失败或警告。

此外，BVT 团队会检查已安装包的 `FullName` 是否与提交文档中的包名称匹配。有关该测试，请参阅 [BVT-10 Version Check](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-10-version-check)。

任何 `<failure>` 标记都表示某种情况会导致你的提交在内容引入和认证阶段被拒绝。虽然系统不会阻止你提交此类包，但这样做很可能会导致延迟。请更正所发现的问题，直到日志中不再包含任何 `<failure>` 标记。

你还可能会在日志中看到 `<warning>` 标记。这些标记通常表示可能需要例外的问题。如果你对任何警告有疑问，请联系你的 [Microsoft 联系人](https://docs.xbox.com/zh-CN/publishing/game-publishing/resources/managed-support/overview-microsoft-representatives-and-contacts.md)。即使你的游戏获得了例外，`<warning>` 标记仍会出现在日志文件中。有关日志消息的完整列表，请参阅 [Submission Validator Messages](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/subval/submissionvalidator-messages.md)。

### 基本配置

游戏运行时不得要求对默认设备设置进行任何更改。BVT 团队会启动游戏，并验证测试游戏时无需更改任何设备设置。有关该测试，请参阅 [BVT-07 Basic Configuration](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-07-basic-configuration)。

在极少数情况下，游戏可能需要更改 DNS 才能连接到合作伙伴服务。请在提交之前与你的 Microsoft 联系人进行讨论。此情况需要获得已批准的例外。

### 脱机可用性

BVT 团队会率先检查游戏在脱机方案中的运行情况。最常见的一些失败包括启动时崩溃，以及在尝试越过初始互动提示时无限期无响应。

**指导：**\
在提交最终包进行认证之前，在测试中加入在脱机状态下启动游戏的操作。确保可以成功浏览所有菜单和游戏模式，或者在需要联网的时间和位置，用户能够到达合理的位置并收到适当的错误提示。

### 语言支持

BVT 团队将确保游戏能够启动、保持稳定，并已本地化为所有受支持的语言。Submission Validator 日志和游戏内语言选择器（如果支持）用于确定预期的语言支持。有关该测试，请参阅 [BVT-05 Languages](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-05-languages)。

**指导：**\
确保游戏能够以每种受支持的语言启动并按预期进行游戏。

### Intelligent Delivery

支持 Intelligent Delivery 的游戏在提交之前必须正确配置。BVT 团队将验证支持级别，以及能否按预期从商店安装内容。有关该测试，请参阅 [BVT-15 Intelligent Delivery](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md#bvt-15-intelligent-delivery)。

### 预购存根文件

提交预购存根文件时，BVT 团队会验证包中是否包含正确的 Store ID。

**指导：**\
确认包中包含正确的 Store ID。


## Related topics

- [认证分步指南](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/certification/certification-guide.md)
- [术语表](https://docs.xbox.com/zh-CN/publishing/game-publishing/glossary.md)
- [经测试的 XBOX 要求](https://docs.xbox.com/zh-CN/publishing/certification/console-cert-tested-requirements.md)
- [认证（Certify）](https://docs.xbox.com/zh-CN/publishing/game-publishing/concepts/certification/certification-overview.md)
- [XBOX 无障碍指南](https://docs.xbox.com/zh-CN/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
