> ## 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 需求](https://docs.xbox.com/zh-TW/publishing/certification/xbox-requirements.md) (XR)。PC 遊戲也必須遵循 [Microsoft Store 原則](https://learn.microsoft.com/windows/apps/publish/store-policies)。

這些需求的一部分是[組建驗證測試](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#BVTs) (BVT)，這是一套旨在判斷遊戲是否已準備好進行完整認證測試的測試。所有遊戲都必須先通過 BVT，才能進入完整的認證測試。未通過 BVT 的遊戲必須修正所有失敗項目，才能重新提交認證。

## 常見的 BVT 失敗

以下是主機和 PC 上常見的 BVT 失敗清單。裝置之間的差異會在適用之處註明。

### 未修正的重新提交條件 (CFR)

遊戲未通過 BVT 的主要原因之一，是新組建未修正先前記錄的所有重新提交條件 (CFR) 或 BVT 失敗。測試小組會先確認先前測試回合中記錄的每個 CFR 都已修正，才會將遊戲排入完整測試。如需相關測試，請參閱 [BVT-09 重新提交條件](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-09-conditions-for-resubmission)。

**指引：**\
提交新組建之前，請確定已修正認證報告中的所有 CFR 和先前所有的 BVT 失敗。

### 遊戲穩定性

遊戲在測試期間必須保持穩定，且不得有任何妨礙測試的問題。BVT 小組會確認所有功能表都可以存取，且所有遊戲模式都可供測試。如需相關測試，請參閱 [BVT-01 組建穩定性](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-01-build-stability)。

**指引：**\
在所有支援的裝置類型和硬體設定上測試遊戲，並在 PC 上使用最新的顯示卡驅動程式。檢閱 [XR-001：遊戲穩定性](https://docs.xbox.com/zh-TW/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 上進行測試，並確定已從裝置中移除所有套件相依性。將遊戲發佈到市集，安裝遊戲，並確認已安裝所有遊戲相依性。將遊戲所需的任何相依性包含在安裝目錄中，或者如果市集未安裝相依性，則在首次開機時提示使用者安裝。

參考：[架構套件相依性](https://docs.xbox.com/zh-TW/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-TW/reference/system/xuser/functions/xuseraddasync.md)

### 合作夥伴託管的服務

當認證小組收到提交時，遊戲所需的合作夥伴服務 (例如多人遊戲服務) 必須正在執行。BVT 小組會先確認這些服務，才會將遊戲排入完整測試。這些服務在整個測試回合期間必須保持正常運作。如需相關測試，請參閱 [BVT-12 合作夥伴託管的服務](https://docs.xbox.com/zh-TW/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 可用性](https://docs.xbox.com/zh-TW/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 配對](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-02-matchmaking)。

如果遊戲支援多人遊戲但不支援配對體驗，BVT 小組會使用系統和遊戲內的邀請及加入功能，讓最少人數的使用者進入對戰。

**指引：**\
提交認證之前，請確定所有支援的多人遊戲功能都已完成、可正常運作且可供測試。

如果遊戲支援可加入的多人遊戲體驗，BVT 小組也會確認系統加入和邀請能如預期運作。遊戲必須允許使用者從**遊戲內**傳送這些可加入體驗的邀請。最常見的問題說明於下列各節。

#### 可加入的遊戲工作階段

提供可加入遊戲工作階段的遊戲必須透過 XBOX 殼層介面啟用可加入性。BVT 小組會確認可從遊戲內以及遊戲外 (遊戲已終止或暫停時) 加入工作階段。

失敗範例包括：

* 使用者無法從系統殼層加入公開大廳。
* 使用者從系統殼層加入時，遊戲未將使用者轉換到工作階段中。

**指引：**\
確認在遊戲正在執行、已終止和已暫停時，使用者都能夠透過 XBOX 殼層介面加入多人遊戲體驗。確認每個可加入的多人遊戲體驗都允許使用者從系統殼層加入。

#### 遊戲邀請

支援可加入多人遊戲體驗的遊戲必須允許玩家使用 XBOX 網路平台，從\_遊戲內\_傳送遊戲邀請給其他 XBOX 網路使用者，包括有跨網路玩家存在的情境。

失敗範例包括：

* 遊戲支援可加入的多人遊戲體驗，但不支援從遊戲內傳送遊戲邀請。
* 使用者接受遊戲邀請時，遊戲未將使用者轉換到預期的多人遊戲體驗。

**指引：**\
對於支援可加入多人遊戲體驗的遊戲，請確認\_遊戲內\_有邀請選項。

### 可下載內容 (DLC)

支援 Durable 和 Consumable 附加元件的遊戲，必須針對每種支援的可下載內容 (DLC) 類型，至少提交一項產品與遊戲一起進行測試。例如，支援賽道包、車輛包和虛擬貨幣包的賽車遊戲，至少需要認證一個賽道、一輛車和一個虛擬貨幣包附加元件。DLC 套件必須能透過搜尋或深層連結在市集中找到，且 BVT 小組會檢查其安裝情況以及在遊戲中的呈現。如需相關測試，請參閱 [BVT-03 DLC](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-03-dlc)。

**指引：**\
提交之前，請將每種支援的 DLC 類型至少一項產品發佈到 CERT 和 CERT.DEBUG 沙箱，讓認證小組可以下載。

### 成就無法解除鎖定 (PC)

符合條件時，遊戲未解除鎖定所有成就。

**指引：**\
確認符合條件時，所有成就都會解除鎖定。

### Submission Validator 與組建識別碼不符

BVT 小組會確認 [Submission Validator](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/subval/submissionvalidator.md) 記錄中的 `<BuildId>` 與提交認證之套件的 `<BuildId>` 相符。請檢查記錄中是否有任何失敗或警告。

此外，BVT 小組會另外檢查已安裝套件的 `FullName` 是否與您提交文件中的套件名稱相符。如需該測試，請參閱 [BVT-10 版本檢查](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-10-version-check)。

任何 `<failure>` 標籤都代表會導致您的提交在內容擷取和認證階段遭到拒絕的狀況。雖然沒有任何機制會阻止您提交這類套件，但這樣做很可能會造成延遲。請修正所識別的問題，直到記錄中不再包含任何 `<failure>` 標籤為止。

您也可能會在記錄中看到 `<warning>` 標籤。這些標籤通常表示可能需要例外狀況的問題。如果您對任何警告有疑問，請聯絡您的 [Microsoft 連絡人](https://docs.xbox.com/zh-TW/publishing/game-publishing/resources/managed-support/overview-microsoft-representatives-and-contacts.md)。即使您的遊戲獲准例外狀況，`<warning>` 標籤仍會出現在記錄檔中。如需記錄訊息的完整清單，請參閱 [Submission Validator 訊息](https://docs.xbox.com/zh-TW/build/core-features/common/packaging/subval/submissionvalidator-messages.md)。

### 基本設定

遊戲不得要求變更預設裝置設定才能執行。BVT 小組會啟動遊戲，並確認不需要變更任何裝置設定即可測試遊戲。如需相關測試，請參閱 [BVT-07 基本設定](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-07-basic-configuration)。

在極少數情況下，遊戲可能需要變更 DNS 才能連線到合作夥伴服務。請在提交前與您的 Microsoft 連絡人討論。這需要核准的例外狀況。

### 離線可用性

BVT 小組會最先檢查遊戲在離線情境中的運作方式。一些最常見的失敗包括啟動時當機，以及嘗試越過初始參與提示時無限期沒有回應。

**指引：**\
在提交最終套件進行認證之前，將在離線狀態下啟動遊戲加入您的測試中。請確保所有功能表和遊戲模式都能成功瀏覽，或在需要線上連線的時機和位置，使用者能夠抵達合理的位置並收到適當的錯誤提示。

### 語言支援

BVT 小組會確保遊戲能夠啟動、保持穩定，並已針對所有支援的語言進行當地語系化。Submission Validator 記錄和遊戲內語言選擇器 (如有支援) 用於判斷預期的語言支援。如需相關測試，請參閱 [BVT-05 語言](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-05-languages)。

**指引：**\
確定遊戲在每種支援的語言中都能如預期啟動和遊玩。

### Intelligent Delivery

支援 Intelligent Delivery 的遊戲在提交之前必須正確設定。BVT 小組會確認支援的程度，以及內容能夠如預期從市集安裝。如需相關測試，請參閱 [BVT-15 Intelligent Delivery](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md#bvt-15-intelligent-delivery)。

### 預購虛設常式檔案

提交預購虛設常式檔案時，BVT 小組會確認套件中包含正確的 Store ID。

**指引：**\
確認套件中包含正確的 Store ID。


## Related topics

- [認證逐步指南](https://docs.xbox.com/zh-TW/publishing/game-publishing/concepts/certification/certification-guide.md)
- [詞彙表](https://docs.xbox.com/zh-TW/publishing/game-publishing/glossary.md)
- [認證 (Certify)](https://docs.xbox.com/zh-TW/publishing/game-publishing/concepts/certification/certification-overview.md)
- [XBOX 遊戲的認證測試 XBOX 需求](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XBOX 無障礙指南](https://docs.xbox.com/zh-TW/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
