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

# XR-132 服務存取限制

> XR-132 對超出 XBOX 網路服務呼叫限制或重試原則的遊戲進行速率限制。測試步驟使用 Fiddler Classic、xbtrace 和 XblTraceAnalyzer。

版本 1.3，10/13/2026

呼叫 XBOX network 服務時超過[遊戲和使用者型限制](https://docs.xbox.com/zh-TW/services/xbox-services/develop/best-practices/live-fine-grained-rate-limiting.md)，或未遵守 XBOX network 服務重試原則的遊戲，可能會受到速率限制，進而可能導致服務中斷或淘汰。未遵守指定的限制可能會使遊戲無法發行，而已發行遊戲在生產環境中發生的問題，可能導致 XBOX network 服務遭到暫停，甚至包括移除遊戲。

> [!NOTE]
>
> 雖然 XR-132 著重於多人遊戲，但如果單人遊戲存取 XBOX network 服務，此需求也可能適用於單人遊戲。例如，如果單人遊戲使用雲端存檔、成就或其他 XBOX network 功能，就必須遵守 XR-132 的指導方針。

## 認證測試案例

### 132-01 服務存取限制

#### 所需工具

* [主機上的 Fiddler](https://docs.xbox.com/zh-TW/build/console-features/networking/tools/fiddler-setup-networking.md) 或 [PC 上的 Fiddler](https://docs.xbox.com/zh-TW/build/console-features/networking/tools/fiddler-pc.md)
* GDK 開發工具下載套件中的 [XBOX services Trace Analyzer](https://aka.ms/xboxlivetoolspackage)。此工具用於檢閱遊戲所發出的服務呼叫，並找出呼叫模式中的任何違規。

#### 測試步驟

**使用 Fiddler Classic：**

1. 在啟動遊戲之前，啟動 Fiddler Classic，並確保其已設定為擷取來自主機或 Windows 10 PC (受測遊戲執行所在的任何裝置) 的網路流量。
2. 在 Fiddler Classic 執行並擷取網路流量的情況下，啟動遊戲並瀏覽所有區域，包括但不限於下列項目：
   * 建立遊戲存檔、重新啟動主機並載入遊戲存檔
   * 快速連續變更豐富狀態 (如果可能)
   * 解鎖成就
   * 張貼至所有排行榜，並使用所有篩選器檢視所有排行榜
   * 檢視遊戲內的朋友清單 (包括已封鎖線上狀態的朋友)，並在頁面之間快速移動
   * 在所有線上模式中進行配對，包括找不到可用工作階段的情況 (如果可能)，並產生語音流量
   * 存取遊戲內商店 (如果適用)
3. 測試結束後，將 Fiddler 擷取儲存至本機目錄。
4. 在 GDK/XDK 命令提示字元中，執行 *XblTraceAnalyzer -data filepath -outputdir filepath*
5. 開啟步驟 4 的輸出目錄，然後開啟「index」檔案 (如果出現提示，請選取「允許封鎖的內容」)。

**使用 *xbtrace.exe***

請注意，*xbtrace.exe* 必須在遊戲啟動後才能啟動，但應盡快啟動，以擷取遊戲在啟動期間發出的任何 XBOX 服務呼叫。因此，擷取遊戲流量的慣用方法是 Fiddler Classic，因為它可以在啟動遊戲之前啟動。

1. 在遊戲執行時，執行 *xbtrace start xboxliveservices*，並瀏覽遊戲的所有區域，包括但不限於下列項目：
   * 建立遊戲存檔、重新啟動主機並載入遊戲存檔
   * 快速連續變更豐富狀態 (如果可能)
   * 解鎖成就
   * 張貼至所有排行榜，並使用所有篩選器檢視所有排行榜
   * 檢視遊戲內的朋友清單 (包括已封鎖線上狀態的朋友)，並在頁面之間快速移動
   * 在所有線上模式中進行配對，包括找不到可用工作階段的情況 (如果可能)，並產生語音流量
   * 存取遊戲內商店 (如果適用)
2. 測試結束後，執行 *xbtrace stop* 兩次。
3. 瀏覽主機的檔案，您會在 SystemScratch > xbtrace 中找到 csv。檢查時間戳記，確定其記錄的是您停止錄製的時間。將其複製到本機。
4. 在 XDK 命令提示字元中，執行 *Xbltraceanalyzer -data filepath -outputdir filepath*。
5. 開啟步驟 4 的輸出目錄，然後開啟「index」檔案 (如果出現提示，請選取「允許封鎖的內容」)。

#### 預期結果

遊戲必須確保其對 XBOX 端點的服務呼叫維持在指定的高載和持續限制以下，且其 XBOX services Trace Analyzer 報告中不得有任何紅色結果。

XBOX services Trace Analyzer 工具會產生 *report.txt* 檔案，指出發現違規的規則，以及這些違規的詳細資料。

> \[!Tip]
> **解讀 XBOX services Trace Analyzer 報告**
>
> * 紅色 - 表示問題超過細部速率限制生效點的 10 倍。這在認證中是嚴重問題。
> * 黃色 - 表示服務因遊戲超過允許的服務呼叫頻率而受到速率限制，但未超過在認證中會被視為嚴重問題的閾值。遊戲應設法解決這些問題。
> * 綠色 - 表示遊戲呼叫 XBOX 服務的頻率低於速率限制生效的頻率。

**通過範例**

1. 遊戲呼叫 XBOX 服務時未超過持續限制。
2. XBOX services Trace Analyzer 報告只包含黃色和/或綠色結果。

**失敗範例**

1. 遊戲超過持續限制 (速率限制生效的限制) 的 10 倍。例如，如果細部速率限制生效的持續限制設定為 300 秒內 300 次呼叫，則在 300 秒內達到或超過 3000 次呼叫的遊戲將不通過。
2. XBOX services Trace Analyzer 報告包含一或多個紅色結果。


## Related topics

- [XBOX 遊戲的認證測試 XBOX 需求](https://docs.xbox.com/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XBOX 遊戲的 XBOX 需求](https://docs.xbox.com/zh-TW/publishing/certification/xbox-requirements.md)
- [精細速率限制](https://docs.xbox.com/zh-TW/services/xbox-services/develop/best-practices/live-fine-grained-rate-limiting.md)
- [XBOX 需求與原則支援內容](https://docs.xbox.com/zh-TW/publishing/certification/xr/overview.md)
- [Beta 版與 XBOX Game Preview 遊戲產品的需求](https://docs.xbox.com/zh-TW/publishing/certification/cert-beta-game-preview.md)