詳細情報
タイトルは、独自のネットワーク操作のパフォーマンスに対応するか、Windows.XBOX.Networking のネットワーク品質 API を使用して現在のネットワーク状態を判断するか、またはその両方を行う必要があります。また、転送するデータ量を減らす、適切なユーザー ロールを選択する、クラウド サービスを使用するなどの方法で、機能を適切に縮退させる必要があります。XBOX 以外のサービスに関する問題の処理
一時的ではないタイムアウト、ネットワーク API エラー、ユーザー エクスペリエンスに影響を与えるサービス構成の欠落など、パートナー サービスに関する問題が発生したタイトルは、利用できない特定の機能またはサービスをユーザーに通知する必要があります。タイトルは、ユーザーがトラブルシューティングを行う間は安全な状態に、またはユーザーが手動で再試行できる状態に、適切にフォールバックする必要があります。 わかりやすいメッセージの例を次に示します。「申し訳ありません。現在、Microsoft 以外のサービス を利用できません。後でもう一度お試しください。詳細については、Microsoft 以外のサポートの連絡先情報 にお問い合わせください。」
XBOX サービスに関する問題の処理
XBOX サービスへの接続が失われると、一部の機能が利用できなくなる場合があります。このような場合、タイトルは明確でわかりやすいメッセージを使用して、このことをユーザーに伝える必要があります。 サービスを利用できない場合、タイトルは要求を再試行できますが、XBOX によって許可されたパラメーターの範囲内でのみ再試行できます。必要な HTTP の再試行とバックオフのロジック、および個々のサービスに関するユーザー操作のガイダンスを含む、XBOX 本体タイトルのサービスの回復性の詳細については、「タイトルのサービス中断に対する回復性」を参照してくださいXBOX 接続の必須化
XBOX 本体向けに開発する場合、機能の大部分でインターネット (特に XBOX) への接続を必要とするタイトルでは、AppX マニフェストにブール型フラグRequireXboxLive を含めることを検討してください。これにより、XBOX を利用できないときは XBOX 本体でタイトルが起動しなくなり、接続が失われた場合はタイトルが中断され、その後終了されます。
GDK を使用したネットワークについては、「ネットワークのセクション」を参照してください。
認定テスト ケース
074-01 XBOX サービスへの WAN 切断
テスト手順- XBOX プロファイルにサインインします。
- 次の操作を実行している間に、WAN ネットワークを切断します。イーサネット スイッチ/ハブを使用している場合は、ネットワーク デバイスからアップリンク ケーブルを取り外します。デバイスが Wi-Fi で接続されている場合は、ワイヤレス アクセス ポイントの接続からアップリンク ケーブルを取り外します。
- 新しいセーブ ポイントの作成
- セーブ ポイントの読み込み
- 自動セーブ ポイントへの到達
- 保存されたゲームの一覧の列挙
- オンライン セッションの検索と参加
- オンライン セッションの作成の試行
- リーダーボードの表示 (該当する場合)
- オフラインでのプレイ
本体が XBOX サービスに到達できない場合、タイトルはわかりやすいエラー メッセージで応答する必要があります。 合格例
- タイトルに、XBOX サービスへのネットワーク接続が失われたことを示すエラー メッセージが表示されます。
- XBOX サービスを必要としないローカル ゲーム モードのプレイ中は、タイトルにエラー メッセージが表示されません。
- AppX マニフェストに
RequireXboxLiveが含まれているタイトルは、接続が失われると中断され、その後終了します。
- ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
- タイトルが応答しない状態または不安定な状態になります。
074-02 直接の切断
テスト手順- タイトルを起動し、XBOX プロファイルにサインインします。
- タイトルで次の操作を実行している間に、デバイスからネットワーク ケーブルを抜くか、WAP またはワイヤレス ルーターの電源をオフにします。
- 新しいセーブ ポイントの作成。
- セーブ ポイントの読み込み。
- 自動セーブ ポイントへの到達。
- 保存されたゲームの一覧の列挙。
- オンライン セッションの検索と参加。
- オンライン セッションの作成の試行。
- リーダーボードの表示 (該当する場合)。
- オフラインでのプレイ。
デバイスが XBOX サービスへの接続を失った場合、タイトルはわかりやすいエラー メッセージで応答する必要があります。 合格例
- オンライン ゲーム モードの間、タイトルにわかりやすいメッセージが表示されます。
- オフライン ゲーム モードの間、タイトルはゲームプレイを中断しません。
- AppX マニフェストに
RequireXboxLiveが含まれているタイトルは、接続が失われると中断され、その後終了します。
- オフライン ゲーム モードの間にエラー メッセージが表示されます。
- タイトルが応答しない状態または不安定な状態になります。
- ネットワークがオフラインになった後も、ユーザーがオンライン メニューを表示したり、バッファーされたメディアを表示したりできます。
074-03 中断時の XBOX サービスからの切断
製品版本体では、次の条件でゲームが中断されます。- 電源モードが [インスタントオン] に設定された状態で電源をオフにして、本体がコネクト スタンバイに入ったとき。
- ゲームが 10 分間フォーカスを失ったままになったとき。たとえば、設定などのアプリケーションを起動して 10 分間フォーカスを保持した場合です。
- 本体の電源モードを [インスタントオン] に設定した状態で、XBOX プロファイルにサインインします。
- ゲームを起動し、ゲームプレイに進みます。
- ゲーム全体のさまざまな時点で、ゲームを中断します。
- ゲームを再開し、ゲームが切断を適切に処理することを確認します。
- ゲーム全体を通じて手順 3 - 4 を繰り返します。
中断後に本体が XBOX サービスに到達できない場合、タイトルは正常に再開し、状況を適切に処理し、必要に応じてわかりやすいエラー メッセージで応答する必要があります。 合格例
- オンラインの XBOX マルチプレイヤー セッション中に、タイトルに XBOX サービスへのネットワーク接続が失われたことを示すエラー メッセージが表示されます。
- XBOX サービスを必要としないローカル ゲーム モードのプレイ中は、タイトルにエラー メッセージが表示されません。
- ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
- タイトルが応答しない状態または不安定な状態になります。
- 再開後に、タイトルに誤解を招くエラー メッセージまたは不正確なエラー メッセージが表示されます。
074-04 中断中の XBOX サービスへの再接続
製品版本体では、次の条件でゲームが中断されます。- 電源モードが [インスタントオン] に設定された状態で電源をオフにして、本体がコネクト スタンバイに入ったとき。
- ゲームが 10 分間フォーカスを失ったままになったとき。たとえば、設定などのアプリケーションを起動して 10 分間フォーカスを保持した場合です。
- 本体の電源モードを [インスタントオン] に設定した状態で XBOX プロファイルにサインインし、本体がホームに設定されていることを確認します。
- XBOX への接続がなく、ローカル ネットワーク接続は維持されている状態で、タイトルを起動します。
- イーサネット スイッチまたはハブを使用している場合は、ネットワーク デバイスからアップリンク ケーブルを取り外します。
- デバイスが Wi-Fi で接続されている場合は、ワイヤレス アクセス ポイントからアップリンク ケーブルを取り外します。
- ゲーム全体のさまざまな時点で、ゲームを中断します。
- アップリンク ケーブルを再接続し、本体が XBOX サービスに再接続するまで待ちます。
- ゲームを再開し、ゲームが再接続を適切に処理することを確認します。
- ゲーム全体を通じて手順 2 - 5 を繰り返します。
中断後に本体が XBOX サービスに到達できない場合、タイトルは正常に再開し、状況を適切に処理し、必要に応じてわかりやすいエラー メッセージで応答する必要があります。 合格例
- ユーザーがタイトルを再開し、オフラインの XBOX ゲーム セッションを中断なしで完了できます。
- タイトルが安定した状態を保ち、クラッシュしません。
- ユーザーが、オンラインではない XBOX ゲーム セッションを完了できません。
- タイトルが応答しない状態または不安定な状態になります。
- 再開後に、タイトルに誤解を招くエラー メッセージまたは不正確なエラー メッセージが表示されます。
074-07 動的な接続の喪失
必要なツール: パートナー サービスをブロックするように XMAT を構成する インストール、キャプチャのセットアップ、およびスクリプト作成の手順については、「XBOX Multiplayer Analysis Tool を使用してネットワーク トラフィックを検査および変更する」を参照してください。- XMAT を管理者として起動し、テスト対象のデバイスに Web Proxy キャプチャを追加します。
- XBOX 開発用本体では、Enable XBOX Proxy を選択し、本体が再起動するまで待ちます。
- Windows では、Start Capture を選択します。
- XMAT でキャプチャしている状態でタイトルを起動し、すべてのメニューを操作し、マルチプレイヤー セッションを完了し、すべてのゲーム モードを読み込み、次を含むタイトルのすべての領域を操作します。
- メニュー。
- リーダーボード。
- サーバー (サーバーを作成し、他のユーザーのサーバーに参加する)。
- フレンド リスト。
- タイトル内ストア。
- 期間限定イベント。
- Host フィルターを使用して、通常のゲームプレイ中に接続されるパートナー サービスのホストを特定します。ブロックする前に、選択したホストが Microsoft、XBOX、または PlayFab に属していないことを確認します。
- Script Editor を開き、SSL Connection Request イベントを選択して、各パートナー サービス ホストについて
Params.Continueをfalseに設定するスクリプトを作成します。 - スクリプトを有効にし、正常にコンパイルされることを確認します。その後、テストの開始時にパートナー サービスが利用可能な状態を保つように、スクリプトを無効にします。XMAT のキャプチャは実行したままにします。
- XMAT のブロック スクリプトを無効にした状態で、XBOX プロファイルにサインインし、タイトルを起動します。
- パートナーがホストするサービスを使用するタイトルの機能に移動し、その機能が利用可能であることを確認します。
- タイトルを閉じずに、XMAT のブロック スクリプトを有効にします。
- タイトルを続行し、次を含む該当するすべての領域を操作します。
- メニュー
- リーダーボード
- サーバー (サーバーを作成し、他のユーザーのサーバーに参加する)
- フレンド リスト
- タイトル内ストア
- 期間限定イベント
- タイトルに、XBOX ネットワークに問題があることを示すエラー メッセージが表示されないことを確認します。
タイトルは、Microsoft 以外のサービスからの切断を適切に処理します。 合格例
- パートナーがホストするサービスへの接続が失われても、タイトルがハングまたはクラッシュしません。
- 表示されたメッセージが、Microsoft サービスに問題があることを示唆しています。
- 内容がわかりにくいエラー メッセージが表示されます。
- タイトルがクラッシュする、不安定になる、または本体の再起動を引き起こします。
074-08 起動前のダウンタイム
必要なツール:- GDK/XDK に含まれる xbstress.exe
- Windows 用の XBOX Multiplayer Analysis Tool (XMAT)。
- 本体で、次のコマンドを使用して、Microsoft 以外のトラフィック用に xbstress.exe で破損したネットワーク チャネルを作成します。
xbstress set channel=0 network=broken addresses=[semicolon delimited list of addresses]
- 次のコマンドでネットワーク シミュレーションを開始します:
xbstress simulate network=channels。 - Windows でテストする場合は、タイトルを起動する前に、XMAT の Web プロキシ キャプチャを構成し、該当するパートナー サービス ホストをブロックするスクリプトを有効にします。
- XBOX プロファイルにサインインします。
- タイトルを起動します。
- Microsoft 以外のオンライン機能にアクセスします。
タイトルは、Microsoft 以外のサービスへの到達に問題があることを示すわかりやすいエラー メッセージを表示し、接続を再試行する機会を提供する必要があります。 合格例
- パートナーがホストするサービスへの接続が失われても、タイトルがハングまたはクラッシュしません。
- 表示されたエラーが、Microsoft サービスに問題があることを示唆しています。
- 内容がわかりにくいエラー メッセージが表示されます。
- タイトルがクラッシュする、不安定になる、または本体の再起動を引き起こします。