> ## 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. # XR-132 服務存取限制 > XR-132 服務存取限制 版本 1.2，11/01/2025 呼叫 XBOX network 服務時超過[遊戲和使用者型限制](/zh-TW/services/xbox-services/develop/best-practices/live-fine-grained-rate-limiting)，或未遵守 XBOX network 服務重試原則的遊戲，可能會受到速率限制，進而可能導致服務中斷或淘汰。未遵守指定的限制可能會使遊戲無法發行，而已發行遊戲在生產環境中發生的問題，可能導致 XBOX network 服務遭到暫停，甚至包括移除遊戲。 > \[!NOTE] > 雖然 XR-132 著重於多人遊戲，但如果單人遊戲存取 XBOX network 服務，此需求也可能適用於單人遊戲。例如，如果單人遊戲使用雲端存檔、成就或其他 XBOX network 功能，就必須遵守 XR-132 的指導方針。 ## 認證測試案例 ### 132-01 服務存取限制 #### 所需工具 * [主機上的 Fiddler](/zh-TW/build/console-features/networking/tools/fiddler-setup-networking) 或 [PC 上的 Fiddler](/zh-TW/build/console-features/networking/tools/fiddler-pc) * 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 報告包含一或多個紅色結果。 ### 132-02 遊戲事件限制 #### 測試步驟 1. 安裝遊戲，並在遊戲執行時瀏覽遊戲的所有區域，包括但不限於下列項目： * 建立遊戲存檔、重新啟動主機並載入遊戲存檔 * 快速連續變更豐富狀態 (如果可能) * 解鎖成就 * 張貼至所有排行榜，並使用所有篩選器檢視所有排行榜 * 檢視遊戲內的朋友清單 (包括已封鎖線上狀態的朋友)，並在頁面之間快速移動 * 在所有線上模式中進行配對，包括找不到可用工作階段的情況 (如果可能)，並產生語音流量 * 存取遊戲內商店 (如果適用) 2. 在測試期間，觀察遊戲是否出現「遊戲事件限制」系統快顯通知。 「遊戲事件限制」系統快顯通知的影像 #### 預期結果 遊戲不得觸發「遊戲事件限制」系統快顯通知。 **通過範例** 1. 遊戲未觸發「遊戲事件限制」系統快顯通知。 **失敗範例** 1. 遊戲觸發「遊戲事件限制」系統快顯通知。 ## Related topics - [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md) - [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md) - [XBOX 需求與原則支援內容](/zh-TW/publishing/certification/xr/overview.md) - [Beta 版與 XBOX Game Preview 遊戲產品的需求](/zh-TW/publishing/certification/cert-beta-game-preview.md) - [XR132 服務存取限制](/zh-TW/publishing/certification/fma/xr-132.md)