次の方法で共有

XR-129: インテリジェント デリバリー コンテンツの管理 *

  • [アーティクル]

バージョン 1.3、2021/4/1

インテリジェント デリバリーをサポートするタイトルは、現在インストールされていないコンテンツが必要になったとき、それを円滑に処理しなければならない。 これを実現するには、ディスクまたは Xbox Live から追加コンテンツをインストールしなければならないときに GDK で PackageInstallChunksAsync を呼び出すか、XDK で AddChunkSpecifiersAsync を呼び出します。

GDK を使用したストリーミング インストールまたはインテリジェント配信の詳細については、「ストリーミング インストールとインテリジェント配信の概要」を参照してください。

その他の情報

インテリジェント デリバリーを使用すると、デバイス固有または言語固有のゲーム コンテンツをインストールしたり、オンデマンドでコンテンツをインストールしたりできます。 ゲーム内で機能/設定を変更することが可能で、それらの変更に自動的にインストールされないコンテンツが必要な場合は、以下の要件を満たす必要があります。

  • 該当コンテンツが使用できないとき、クラッシュしたり無反応状態になったりしない。
  • PackageInstallChunksAsync (GDK) または AddChunkSpecifiersAsync (XDK) API を使用して、インストールを正しく開始します。 タイトルは、XPackageCreateInstallationMonitor (GDK) または AddChunkSpecifiersAsync API (XDK) を使用して取得した PackageTransferWatcher オブジェクトのイベントとメソッドを使用して、タイトルによって開始されたコンテンツのインストールに関する進行状況を表示することを強くお勧めします。

シナリオ例:

言語パック

ユーザーの本体の言語設定では en-US が使用されていて、インテリジェント デリバリーで fr-FR、it-IT、es-SP、fr-CA、de-AU、および ja-JP 言語も提供します。 既定では、ユーザーは本体を en-US に設定しているため、プラットフォームはベース インストールとして en-US の言語チャンクをインストールします。

ただし、ゲーム内メニューで言語選択オプションが提供されている場合、ユーザーが当初インストールされたものとは別の言語を選択したときには、追加の言語コンテンツのインストールを開始する必要があります。

デバイス

ユーザーは当初、Xbox One S のタイトルとして外部ドライブにゲームをインストールしました。 その後、Xbox One X 本体に外部ドライブを移動しました。 プラットフォームは、起動マーカーよりも前の Xbox One X のチャンクを自動的にインストールしますが、Xbox One X に固有の起動セットに含まれていないコンテンツは、タイトルが自身の起動セットから実行可能である間にストリーミングされます。 タイトルは、そのデバイス タイプのチャンクがインストールされていることを確認し、それらのチャンクを待機している間、このシナリオを円滑に処理しなければなりません。 また、テクスチャーの改善などのデバイス固有の最適化を提供するタイトルは、このシナリオをコンテンツ管理エクスペリエンスの一部とみなす必要があります。

オンデマンド コンテンツ

ユーザーは、マルチプレイヤー キャンペーン、キャラクター エディター、およびレベル エディターが含まれるゲームをプレイしています。 タイトルは、これらをレイアウト ファイル内でオンデマンド アセットとしてマークしました。 タイトルは、これらのモードのメニュー エントリで、コンテンツのインストールが必要になることを示さなければなりません。 ユーザーがいずれかのメニュー エントリを選択した場合、またはタイトルがコンテンツを必要とする場合、タイトルはコンテンツのインストールを要求する必要があります。 ユーザーはコンテンツのインストールの要求をキャンセルすることができ、タイトルは AddChunkSpecifiersAsync からの戻り値を正常に処理する必要があります。

実装に関するガイダンスとベスト プラクティス

その他のリソース

サーティフィケーション テスト ケース

129-01 言語パックのインテリジェント デリバリー

必要なツール:

  • 1 x Xbox One
  • 1 x Xbox One S
  • 1 x Xbox One X
  • 1 x Xbox Series X 開発キット (Xbox Series X|S リテール版本体モードの使用)

テスト手順

  1. Xbox One 本体を、対応している言語に設定します。
  2. タイトルをインストールします。
  3. タイトルを起動します。
  4. タイトルを操作し、本体で選択した言語とエクスペリエンスが一致していることを確認します。
  5. ゲーム内メニューに言語を切り替えるオプションがある場合は、各言語を選択して、その言語の各チャンクをインストールします。
  6. 対応しているすべての言語で、手順 1 - 5 を繰り返します。
  7. すべての世代のデバイスで手順 1 - 6 を繰り返します。

想定される結果
必要な言語パックが期待どおりにインストールされます。

成功例

  1. 本体の言語設定に基づく必要な言語パックがインストールされます。
  2. メニュー オプションで別の言語を選択すると、適切な言語パックがインストールされます。
  3. タイトルは安定した状態を保ち、クラッシュしたり無反応状態になったりしません。

失敗例

  1. 本体の言語設定に基づく必要な言語パックがインストールされません。
  2. メニュー オプションで別の言語を選択しても、適切な言語パックがインストールされません。
  3. タイトルが、クラッシュするか無反応状態になります。

129-02 デバイス固有のコンテンツのインテリジェント デリバリー

必要なツール:

  • 1 x Xbox One
  • 1 x Xbox One S
  • 1 x Xbox One X
  • 1 x Xbox Series X 開発キット (Xbox Series X|S リテール版本体モードの使用)

テスト手順

  1. Xbox One 本体を、対応している言語に設定します。
  2. タイトルをインストールします。
  3. タイトルを起動します。
  4. タイトルを操作し、Xbox One 固有のコンテンツのみがインストールされていることを確認します。
  5. すべての世代のデバイスで手順 1 - 4 を繰り返し、すべての世代固有のコンテンツがインストールされていることを確認します。
  6. 対応しているすべての言語で、手順 1 - 5 を繰り返します。

想定される結果
必要なデバイス固有のコンテンツが期待どおりにインストールされます。

成功例

  1. 必要なデバイス固有のコンテンツがインストールされます。
  2. タイトルは安定した状態を保ち、クラッシュしたり無反応状態になったりしません。

失敗例

  1. 必要なデバイス固有のコンテンツがインストールされません。
  2. タイトルが、クラッシュするか無反応状態になります。

129-03 デバイス固有のコンテンツの移行

必要なツール:

  • 1 x Xbox One
  • 1 x Xbox One S
  • 1 x Xbox One X
  • 1 x Xbox Series X 開発キット (Xbox Series X|S リテール版本体モードの使用)

テスト手順

  1. [Xbox One 本体] Xbox One 本体を対応している言語に設定します。
  2. [Xbox One 本体] 外部 USB デバイスにタイトルをインストールします。
  3. [Xbox One 本体] タイトルを起動します。
  4. [Xbox One 本体] タイトルを操作し、Xbox One 固有のコンテンツのみがインストールされていることを確認します。
  5. USB デバイスを Xbox One X 本体に移動します。
  6. [Xbox One X 本体] 更新プログラムを取得して Xbox One X 固有のコンテンツをインストールします。
  7. [Xbox One X 本体] タイトルを起動し、Xbox One X の追加コンテンツのインストールが円滑に処理されることを確認します。
  8. USB デバイスを Xbox One 本体に戻します。
  9. [Xbox One 本体] タイトルを操作し、インストール中の両方のプラットフォームのコンテンツが円滑に処理されることを確認します。
  10. Xbox One Series X|S で手順 [5] – [9] を繰り返します。

想定される結果
必要なデバイス固有のコンテンツが期待どおりにインストールされます。

成功例

  1. 必要なデバイス固有のコンテンツがインストールされます。
  2. タイトルは安定した状態を保ち、クラッシュしたり無反応状態になったりしません。

失敗例

  1. タイトルが、クラッシュするか無反応状態になります。

129-04 オンデマンド コンテンツのインテリジェント デリバリー

必要なツール:

  • 1 x Xbox One
  • 1 x Xbox One S
  • 1 x Xbox One X
  • 1 x Xbox Series X 開発キット (Xbox Series X|S リテール版本体モードの使用)

テスト手順

  1. Xbox One 本体を、対応している言語に設定します。
  2. タイトルをインストールします。
  3. タイトルを起動します。
  4. オンデマンド コンテンツをすべてインストールします。
  5. 対応しているすべての言語で、手順 1 - 4 を繰り返します。
  6. すべての世代のデバイスで手順 1 - 5 を繰り返します。

想定される結果
オンデマンド コンテンツが期待どおりにインストールされます。

成功例

  1. オンデマンド コンテンツが期待どおりにインストールされます。
  2. タイトルは安定した状態を保ち、クラッシュしたり無反応状態になったりしません。

失敗例

  1. オンデマンド コンテンツが期待どおりにインストールされません。
  2. タイトルが、クラッシュするか無反応状態になります。

129-05 機能とレシピ

必要なツール:

  • 1 x Xbox One
  • 1 x Xbox One S
  • 1 x Xbox One X
  • 1 x Xbox Series X 開発キット (Xbox Series X|S リテール版本体モードの使用)

テスト手順

  1. ベース タイトルを、機能とレシピに関連付けられているオプションのコンテンツなしでインストールします。
  2. タイトルのすべての領域に移動し、インストールされていないコンテンツへのアクセスを試み、タイトルが安定していることを確認します。
  3. システム UI に公開される各機能ごとに、機能をインストールし、タイトル内でアクセスを試み、タイトルが安定していることを確認します。
  4. システム UI に公開されていない各機能ごとに、タイトル内 UI オプションを使用して機能ビューをインストールし、タイトルが安定していることを確認します。
  5. レシピごとに、ユーザーが関連するストアの資格を所有していることを確認し、新しいインストールを実行します。
  6. レシピに含まれるすべての機能が、タイトル内にインストールされ、アクセスできることを確認します。

想定される結果
タイトルは、オプションのコンテンツがインストールされていない場合は、安定した状態を維持し、インストールされている場合は、オプションのコンテンツへのアクセスを許可します。

成功例

  1. オプションのコンテンツがインストールされていない場合、タイトルは安定した状態を維持します。
  2. オプションのコンテンツがインストールされている場合、タイトルはオプションのコンテンツへのアクセスを許可します。

失敗例

  1. タイトルは、オプションのコンテンツがインストールされていないときに、クラッシュするか無反応状態になります。
  2. タイトルは、インストールされた際にオプションのコンテンツへのアクセスを許可しません。