XR-132 服務存取限制

版本 1.2，11/01/2025 呼叫 XBOX network 服務時超過遊戲和使用者型限制，或未遵守 XBOX network 服務重試原則的遊戲，可能會受到速率限制，進而可能導致服務中斷或淘汰。未遵守指定的限制可能會使遊戲無法發行，而已發行遊戲在生產環境中發生的問題，可能導致 XBOX network 服務遭到暫停，甚至包括移除遊戲。

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

​

認證測試案例

​

132-01 服務存取限制

​

所需工具

• 主機上的 Fiddler 或 PC 上的 Fiddler
• GDK 開發工具下載套件中的 XBOX services Trace Analyzer。此工具用於檢閱遊戲所發出的服務呼叫，並找出呼叫模式中的任何違規。

​

測試步驟

使用 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. 遊戲觸發「遊戲事件限制」系統快顯通知。