XR-132: サービスアクセスの制限 *
バージョン 1.2、2025/11/01 XBOX ネットワークサービスを呼び出す際にタイトルおよびユーザーベースの制限を超えるタイトル、または XBOX ネットワークサービスの再試行ポリシーに従わないタイトルは、レート制限の対象となり、サービスの中断や廃止につながる可能性があります。指定された制限に従わないと、タイトルのリリースがブロックされる可能性があり、リリース済みタイトルの本番環境の問題は、タイトルの削除を含む XBOX ネットワークサービスの停止につながる可能性があります。XR-132 はマルチプレイヤーゲームに焦点を当てていますが、XBOX ネットワークサービスにアクセスするシングルプレイヤーゲームにも適用される場合があります。たとえば、シングルプレイヤーゲームがクラウドセーブ、実績、その他の XBOX ネットワーク機能を使用する場合、XR-132 ガイドラインを遵守する必要があります。
認定テストケース
132-01 サービスアクセスの制限
必要なツール
- 本体上の Fiddler または PC 上の Fiddler
- GDK 開発ツールダウンロードパッケージの XBOX services Trace Analyzer。タイトルが行うサービス呼び出しを確認し、呼び出しパターンの違反を見つけるために使用されます。
テスト手順
Fiddler Classic を使用する場合:- タイトルを起動する前に Fiddler Classic を起動し、本体または Windows 10 PC (対象のタイトルが実行される場所) からのネットワークトラフィックをキャプチャするように構成されていることを確認します。
- Fiddler Classic を実行してネットワークトラフィックをキャプチャした状態で、タイトルを起動し、以下を含むがこれらに限定されないすべての領域を通過します。
- ゲームセーブを作成し、本体を再起動してゲームセーブを読み込む
- リッチプレゼンスの状態を素早く連続して変更する (可能であれば)
- 実績のアンロックと表示
- すべてのリーダーボードに投稿し、すべてのフィルターを使用してすべてのリーダーボードを表示する
- ゲーム内フレンドリストを表示 (プレゼンスがブロックされているフレンドを含む) し、ページを素早く移動する
- Hero Stat を獲得して表示する
- 利用可能なセッションが見つからない (可能であれば) 場合も含め、すべてのオンラインモードでマッチメイキングし、音声トラフィックを生成する
- ゲームクリップを作成、保存、共有する
- ゲーム内ストアにアクセスする (該当する場合)
- テストが終了したら、Fiddler のキャプチャをローカルディレクトリに保存します。
- GDK/XDK コマンドプロンプトで、
XblTraceAnalyzer -data filepath -outputdir filepathを実行します。 - 手順 4 の出力ディレクトリを開き、「index」ファイルを開きます (プロンプトが表示された場合は「Allow blocked content」を選択します)。
xbtrace.exe を使用する場合
xbtrace.exe はタイトルの起動まで開始できないことに注意してください。しかし、タイトルが起動時に行う XBOX サービス呼び出しをキャプチャするために、できるだけ早く開始する必要があります。このため、タイトルのトラフィックをキャプチャするための推奨方法は、タイトルの起動前に開始できる Fiddler Classic です。
- タイトルを実行した状態で、
xbtrace start xboxliveservicesを実行し、以下を含むがこれらに限定されないタイトルのすべての領域に進みます。- ゲームセーブを作成し、本体を再起動してゲームセーブを読み込む
- リッチプレゼンスの状態を素早く連続して変更する (可能であれば)
- 実績のアンロックと表示
- すべてのリーダーボードに投稿し、すべてのフィルターを使用してすべてのリーダーボードを表示する
- ゲーム内フレンドリストを表示 (プレゼンスがブロックされているフレンドを含む) し、ページを素早く移動する
- Hero Stat を獲得して表示する
- 利用可能なセッションが見つからない (可能であれば) 場合も含め、すべてのオンラインモードでマッチメイキングし、音声トラフィックを生成する
- ゲームクリップを作成、保存、共有する
- ゲーム内ストアにアクセスする (該当する場合)
- テストが終了したら、
xbtrace stopを 2 回実行します。 - 本体のファイルを参照し、
SystemScratch > xbtraceで csv が見つかります。タイムスタンプを確認して、記録を停止した時刻が登録されていることを確認します。ローカルにコピーします。 - XDK コマンドプロンプトで、
Xbltraceanalyzer -data filepath -outputdir filepathを実行します。 - 手順 4 の出力ディレクトリを開き、「index」ファイルを開きます (プロンプトが表示された場合は「Allow blocked content」を選択します)。
期待される結果
タイトルは、XBOX エンドポイントへのサービス呼び出しを指定されたバーストおよびサステイン制限以下に保ち、XBOX services Trace Analyzer レポートに赤い結果がないことを保証する必要があります。 XBOX services Trace Analyzer ツールは、違反が見つかったルールと、それらの違反の詳細を示すreport.txt ファイルを生成します。
合格の例
- タイトルは XBOX サービスを呼び出す際にサステイン制限を超えません。
- XBOX services Trace Analyzer レポートには黄と緑の結果しか含まれません。
- タイトルはサステイン制限 (レート制限が有効になる制限) を 10 倍超えます。たとえば、Fine Grain Rate Limiting が有効になるサステイン制限が 300 秒間に 300 回の呼び出しに設定されている場合、300 秒間に 3000 回以上の呼び出しを行うタイトルは不合格となります。
- XBOX services Trace Analyzer レポートに 1 つ以上の赤い結果が含まれます。
132-02 ゲームイベントの制限
テスト手順
- タイトルをインストールし、タイトルを実行した状態で、以下を含むがこれらに限定されないタイトルのすべての領域を移動します。
- ゲームセーブを作成し、本体を再起動してゲームセーブを読み込む
- リッチプレゼンスの状態を素早く連続して変更する (可能であれば)
- 実績のアンロックと表示
- すべてのリーダーボードに投稿し、すべてのフィルターを使用してすべてのリーダーボードを表示する
- ゲーム内フレンドリストを表示 (プレゼンスがブロックされているフレンドを含む) し、ページを素早く移動する
- Hero Stat を獲得して表示する
- 利用可能なセッションが見つからない (可能であれば) 場合も含め、すべてのオンラインモードでマッチメイキングし、音声トラフィックを生成する
- ゲームクリップを作成、保存、共有する
- ゲーム内ストアにアクセスする (該当する場合)
- テスト中、タイトルを観察し、Game Event Limitations のシステムトーストが表示されるかを確認します。
期待される結果
ゲームは Game Event Limitations のシステムトーストをトリガーしてはなりません。 合格の例- タイトルは Game Event Limitations のシステムトーストをトリガーしません。
- タイトルは Game Event Limitations のシステムトーストをトリガーします。
