> ## 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-074 XBOX およびパートナー サービスへの接続の喪失

> タイトルが XBOX およびパートナー サービスへの接続の喪失を処理する方法。再試行ポリシー、わかりやすいエラー メッセージ、RequireXboxLive フラグを含みます。

バージョン 2.0、2025/11/1

タイトルは、XBOX およびパートナー サービスとの接続に関するエラーを適切に処理する必要があります。タイトルは、エラーが発生した後に XBOX サービスへの要求を再試行する場合、XBOX によって設定された再試行ポリシーに従う必要があります。タイトルは、サービスを利用できない場合に、ユーザーへのメッセージ表示を適切に管理する必要があります。パートナー サービスを利用できない場合、ゲームは XBOX ネットワークに問題があることを示してはなりません。ネットワーク サービスが低速になったり断続的にしか利用できなくなったりした場合でも、タイトルがクラッシュまたはハングしてはなりません。

## 詳細情報

タイトルは、独自のネットワーク操作のパフォーマンスに対応するか、**Windows.XBOX.Networking** のネットワーク品質 API を使用して現在のネットワーク状態を判断するか、またはその両方を行う必要があります。また、転送するデータ量を減らす、適切なユーザー ロールを選択する、クラウド サービスを使用するなどの方法で、機能を適切に縮退させる必要があります。

### XBOX 以外のサービスに関する問題の処理

一時的ではないタイムアウト、ネットワーク API エラー、ユーザー エクスペリエンスに影響を与えるサービス構成の欠落など、パートナー サービスに関する問題が発生したタイトルは、利用できない特定の機能またはサービスをユーザーに通知する必要があります。タイトルは、ユーザーがトラブルシューティングを行う間は安全な状態に、またはユーザーが手動で再試行できる状態に、適切にフォールバックする必要があります。

わかりやすいメッセージの例を次に示します。

> 「申し訳ありません。現在、*Microsoft 以外のサービス* を利用できません。後でもう一度お試しください。詳細については、*Microsoft 以外のサポートの連絡先情報* にお問い合わせください。」

### XBOX サービスに関する問題の処理

XBOX サービスへの接続が失われると、一部の機能が利用できなくなる場合があります。このような場合、タイトルは明確でわかりやすいメッセージを使用して、このことをユーザーに伝える必要があります。

サービスを利用できない場合、タイトルは要求を再試行できますが、XBOX によって許可されたパラメーターの範囲内でのみ再試行できます。必要な HTTP の再試行とバックオフのロジック、および個々のサービスに関するユーザー操作のガイダンスを含む、XBOX 本体タイトルのサービスの回復性の詳細については、「[タイトルのサービス中断に対する回復性](https://docs.xbox.com/ja-jp/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)」を参照してください

### XBOX 接続の必須化

XBOX 本体向けに開発する場合、機能の大部分でインターネット (特に XBOX) への接続を必要とするタイトルでは、AppX マニフェストにブール型フラグ `RequireXboxLive` を含めることを検討してください。これにより、XBOX を利用できないときは XBOX 本体でタイトルが起動しなくなり、接続が失われた場合はタイトルが中断され、その後終了されます。

GDK を使用したネットワークについては、「[ネットワークのセクション](https://docs.xbox.com/ja-jp/build/console-features/networking/gc-networking-toc.md)」を参照してください。

## 認定テスト ケース

### 074-01 XBOX サービスへの WAN 切断

**テスト手順**

1. XBOX プロファイルにサインインします。
2. 次の操作を実行している間に、WAN ネットワークを切断します。イーサネット スイッチ/ハブを使用している場合は、ネットワーク デバイスからアップリンク ケーブルを取り外します。デバイスが Wi-Fi で接続されている場合は、ワイヤレス アクセス ポイントの接続からアップリンク ケーブルを取り外します。
   * 新しいセーブ ポイントの作成
   * セーブ ポイントの読み込み
   * 自動セーブ ポイントへの到達
   * 保存されたゲームの一覧の列挙
   * オンライン セッションの検索と参加
   * オンライン セッションの作成の試行
   * リーダーボードの表示 (該当する場合)
   * オフラインでのプレイ

**期待される結果**\
本体が XBOX サービスに到達できない場合、タイトルはわかりやすいエラー メッセージで応答する必要があります。

**合格例**

1. タイトルに、XBOX サービスへのネットワーク接続が失われたことを示すエラー メッセージが表示されます。
2. XBOX サービスを必要としないローカル ゲーム モードのプレイ中は、タイトルにエラー メッセージが表示されません。
3. AppX マニフェストに `RequireXboxLive` が含まれているタイトルは、接続が失われると中断され、その後終了します。

**不合格例**

1. ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
2. タイトルが応答しない状態または不安定な状態になります。

### 074-02 直接の切断

**テスト手順**

1. タイトルを起動し、XBOX プロファイルにサインインします。
2. タイトルで次の操作を実行している間に、デバイスからネットワーク ケーブルを抜くか、WAP またはワイヤレス ルーターの電源をオフにします。
   * 新しいセーブ ポイントの作成。
   * セーブ ポイントの読み込み。
   * 自動セーブ ポイントへの到達。
   * 保存されたゲームの一覧の列挙。
   * オンライン セッションの検索と参加。
   * オンライン セッションの作成の試行。
   * リーダーボードの表示 (該当する場合)。
   * オフラインでのプレイ。

**期待される結果**\
デバイスが XBOX サービスへの接続を失った場合、タイトルはわかりやすいエラー メッセージで応答する必要があります。

**合格例**

1. オンライン ゲーム モードの間、タイトルにわかりやすいメッセージが表示されます。
2. オフライン ゲーム モードの間、タイトルはゲームプレイを中断しません。
3. AppX マニフェストに `RequireXboxLive` が含まれているタイトルは、接続が失われると中断され、その後終了します。

**不合格例**

1. オフライン ゲーム モードの間にエラー メッセージが表示されます。
2. タイトルが応答しない状態または不安定な状態になります。
3. ネットワークがオフラインになった後も、ユーザーがオンライン メニューを表示したり、バッファーされたメディアを表示したりできます。

### 074-03 中断時の XBOX サービスからの切断

製品版本体では、次の条件でゲームが中断されます。

* 電源モードが \[インスタントオン] に設定された状態で電源をオフにして、本体がコネクト スタンバイに入ったとき。
* ゲームが 10 分間フォーカスを失ったままになったとき。たとえば、設定などのアプリケーションを起動して 10 分間フォーカスを保持した場合です。

このテスト ケースでは、手順 3 で両方の方法を検証する必要があります。

**テスト手順**

1. 本体の電源モードを \[インスタントオン] に設定した状態で、XBOX プロファイルにサインインします。
2. ゲームを起動し、ゲームプレイに進みます。
3. ゲーム全体のさまざまな時点で、ゲームを中断します。
4. ゲームを再開し、ゲームが切断を適切に処理することを確認します。
5. ゲーム全体を通じて手順 3 - 4 を繰り返します。

**期待される結果**\
中断後に本体が XBOX サービスに到達できない場合、タイトルは正常に再開し、状況を適切に処理し、必要に応じてわかりやすいエラー メッセージで応答する必要があります。

**合格例**

1. オンラインの XBOX マルチプレイヤー セッション中に、タイトルに XBOX サービスへのネットワーク接続が失われたことを示すエラー メッセージが表示されます。
2. XBOX サービスを必要としないローカル ゲーム モードのプレイ中は、タイトルにエラー メッセージが表示されません。

**不合格例**

1. ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
2. タイトルが応答しない状態または不安定な状態になります。
3. 再開後に、タイトルに誤解を招くエラー メッセージまたは不正確なエラー メッセージが表示されます。

### 074-04 中断中の XBOX サービスへの再接続

製品版本体では、次の条件でゲームが中断されます。

* 電源モードが \[インスタントオン] に設定された状態で電源をオフにして、本体がコネクト スタンバイに入ったとき。
* ゲームが 10 分間フォーカスを失ったままになったとき。たとえば、設定などのアプリケーションを起動して 10 分間フォーカスを保持した場合です。

このテスト ケースでは、手順 3 で両方の方法を検証する必要があります。

**テスト手順**

1. 本体の電源モードを \[インスタントオン] に設定した状態で XBOX プロファイルにサインインし、本体がホームに設定されていることを確認します。
2. XBOX への接続がなく、ローカル ネットワーク接続は維持されている状態で、タイトルを起動します。
   * イーサネット スイッチまたはハブを使用している場合は、ネットワーク デバイスからアップリンク ケーブルを取り外します。
   * デバイスが Wi-Fi で接続されている場合は、ワイヤレス アクセス ポイントからアップリンク ケーブルを取り外します。
3. ゲーム全体のさまざまな時点で、ゲームを中断します。
4. アップリンク ケーブルを再接続し、本体が XBOX サービスに再接続するまで待ちます。
5. ゲームを再開し、ゲームが再接続を適切に処理することを確認します。
6. ゲーム全体を通じて手順 2 - 5 を繰り返します。

**期待される結果**\
中断後に本体が XBOX サービスに到達できない場合、タイトルは正常に再開し、状況を適切に処理し、必要に応じてわかりやすいエラー メッセージで応答する必要があります。

**合格例**

1. ユーザーがタイトルを再開し、オフラインの XBOX ゲーム セッションを中断なしで完了できます。
2. タイトルが安定した状態を保ち、クラッシュしません。

**不合格例**

1. ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
2. タイトルが応答しない状態または不安定な状態になります。
3. 再開後に、タイトルに誤解を招くエラー メッセージまたは不正確なエラー メッセージが表示されます。

### 074-07 動的な接続の喪失

**必要なツール:**

* [XBOX Multiplayer Analysis Tool (XMAT) のドキュメント](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md)および[最新の XMAT リリース](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases)。

**パートナー サービスをブロックするように XMAT を構成する**

インストール、キャプチャのセットアップ、およびスクリプト作成の手順については、「[XBOX Multiplayer Analysis Tool を使用してネットワーク トラフィックを検査および変更する](https://docs.xbox.com/ja-jp/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)」を参照してください。

1. XMAT を管理者として起動し、テスト対象のデバイスに **Web Proxy** キャプチャを追加します。
   * XBOX 開発用本体では、**Enable XBOX Proxy** を選択し、本体が再起動するまで待ちます。
   * Windows では、**Start Capture** を選択します。
2. XMAT でキャプチャしている状態でタイトルを起動し、すべてのメニューを操作し、マルチプレイヤー セッションを完了し、すべてのゲーム モードを読み込み、次を含むタイトルのすべての領域を操作します。
   * メニュー。
   * リーダーボード。
   * サーバー (サーバーを作成し、他のユーザーのサーバーに参加する)。
   * フレンド リスト。
   * タイトル内ストア。
   * 期間限定イベント。
3. **Host** フィルターを使用して、通常のゲームプレイ中に接続されるパートナー サービスのホストを特定します。ブロックする前に、選択したホストが Microsoft、XBOX、または PlayFab に属していないことを確認します。
4. **Script Editor** を開き、**SSL Connection Request** イベントを選択して、各パートナー サービス ホストについて `Params.Continue` を `false` に設定するスクリプトを作成します。
5. スクリプトを有効にし、正常にコンパイルされることを確認します。その後、テストの開始時にパートナー サービスが利用可能な状態を保つように、スクリプトを無効にします。XMAT のキャプチャは実行したままにします。

**テスト手順**

1. XMAT のブロック スクリプトを無効にした状態で、XBOX プロファイルにサインインし、タイトルを起動します。
2. パートナーがホストするサービスを使用するタイトルの機能に移動し、その機能が利用可能であることを確認します。
3. タイトルを閉じずに、XMAT のブロック スクリプトを有効にします。
4. タイトルを続行し、次を含む該当するすべての領域を操作します。
   * メニュー
   * リーダーボード
   * サーバー (サーバーを作成し、他のユーザーのサーバーに参加する)
   * フレンド リスト
   * タイトル内ストア
   * 期間限定イベント
5. タイトルに、XBOX ネットワークに問題があることを示すエラー メッセージが表示されないことを確認します。

**期待される結果**\
タイトルは、Microsoft 以外のサービスからの切断を適切に処理します。

**合格例**

1. パートナーがホストするサービスへの接続が失われても、タイトルがハングまたはクラッシュしません。

**不合格例**

1. 表示されたメッセージが、Microsoft サービスに問題があることを示唆しています。
2. 内容がわかりにくいエラー メッセージが表示されます。
3. タイトルがクラッシュする、不安定になる、または本体の再起動を引き起こします。

### 074-08 起動前のダウンタイム

**必要なツール:**

* GDK/XDK に含まれる *xbstress.exe*
* Windows 用の [XBOX Multiplayer Analysis Tool (XMAT)](https://docs.xbox.com/ja-jp/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)。

**テスト手順**

1. 本体で、次のコマンドを使用して、Microsoft 以外のトラフィック用に *xbstress.exe* で破損したネットワーク チャネルを作成します。

`xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]`

2. 次のコマンドでネットワーク シミュレーションを開始します: `xbstress simulate network=channels`。
3. Windows でテストする場合は、タイトルを起動する前に、XMAT の Web プロキシ キャプチャを構成し、該当するパートナー サービス ホストをブロックするスクリプトを有効にします。
4. XBOX プロファイルにサインインします。
5. タイトルを起動します。
6. Microsoft 以外のオンライン機能にアクセスします。

**期待される結果**\
タイトルは、Microsoft 以外のサービスへの到達に問題があることを示すわかりやすいエラー メッセージを表示し、接続を再試行する機会を提供する必要があります。

**合格例**

1. パートナーがホストするサービスへの接続が失われても、タイトルがハングまたはクラッシュしません。

**不合格例**

1. 表示されたエラーが、Microsoft サービスに問題があることを示唆しています。
2. 内容がわかりにくいエラー メッセージが表示されます。
3. タイトルがクラッシュする、不安定になる、または本体の再起動を引き起こします。


## Related topics

- [XBOX ゲーム向け認定テスト対象 XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/console-cert-tested-requirements.md)
- [XBOX ゲーム向け XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/xbox-requirements.md)
- [XBOX Requirements とポリシーのサポート コンテンツ](https://docs.xbox.com/ja-jp/publishing/certification/xr/overview.md)
- [XR074 XBOX およびパートナー サービスへの接続の切断](https://docs.xbox.com/ja-jp/publishing/certification/fma/xr-074.md)
- [XBOX Multiplayer Analysis Tool を使用したネットワーク トラフィックの検査と変更](https://docs.xbox.com/ja-jp/tools/tools-services/live-xbox-multiplayer-analysis-tool.md)