> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XR-129 Intelligent Delivery のコンテンツ管理

> Intelligent Delivery をサポートするタイトルは、PackageInstallChunksAsync または AddChunkSpecifiersAsync を使用して、インストールされていないコンテンツを適切に処理する必要があります。

# XR-129: Intelligent Delivery のコンテンツ管理 \*

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

Intelligent Delivery をサポートするタイトルは、現在インストールされていないコンテンツが必要になった際に、シナリオを適切に処理する必要があります。タイトルは、ディスクまたは XBOX Live から追加のコンテンツをインストールする必要がある場合、GDK では `PackageInstallChunksAsync` を、XDK では `AddChunkSpecifiersAsync` を呼び出すことでこれを実現できます。

GDK での Streaming Install または Intelligent Delivery の詳細については、GDK ドキュメントの Streaming Install and Intelligent Delivery overview を参照してください。

## 詳細情報

Intelligent Delivery を使用すると、タイトルはデバイス固有、言語固有、またはオンデマンドのゲームコンテンツのインストールを利用できます。自動的にインストールされないコンテンツが必要となるゲーム内の機能/設定の変更を許可するタイトルは、以下を満たす必要があります。

* コンテンツが利用できない場合にクラッシュしたり応答しなくなったりしない。
* `PackageInstallChunksAsync` (GDK) または `AddChunkSpecifiersAsync` (XDK) API を使用してインストールを正しく開始する。

タイトルによって開始されたコンテンツのインストールに関する進行状況を、`XPackageCreateInstallationMonitor` (GDK) または `AddChunkSpecifiersAsync` API (XDK) を使用して取得した `PackageTransferWatcher` オブジェクトのイベントとメソッドを使用してタイトルが表示することを強く推奨します。

**シナリオ例:**

**言語パック**

ユーザーが本体の言語設定として en-US を使用しており、Intelligent Delivery を介して 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 言語パックの Intelligent Delivery

**必要なツール**

* XBOX One × 1
* XBOX One S × 1
* XBOX One X × 1
* XBOX Series X Dev Kit × 1 (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 デバイス固有コンテンツの Intelligent Delivery

**必要なツール**

* XBOX One × 1
* XBOX One S × 1
* XBOX One X × 1
* XBOX Series X Dev Kit × 1 (XBOX Series X|S 小売コンソールモードを使用)

**テスト手順**

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

**期待される結果**

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

**合格の例**

1. タイトルは、想定されるデバイス固有のコンテンツをインストールします。
2. タイトルは安定した状態を維持し、クラッシュしたり応答しなくなったりしません。

**不合格の例**

1. タイトルは、想定されるデバイス固有のコンテンツをインストールしません。
2. タイトルがクラッシュしたり応答しなくなったりします。

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

**必要なツール**

* XBOX One × 1
* XBOX One S × 1
* XBOX One X × 1
* XBOX Series X Dev Kit × 1 (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 Series X|S で手順 5〜9 を繰り返します。

**期待される結果**

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

**合格の例**

1. タイトルは、想定されるデバイス固有のコンテンツをインストールします。
2. タイトルは安定した状態を維持し、クラッシュしたり応答しなくなったりしません。

**不合格の例**

1. タイトルがクラッシュしたり応答しなくなったりします。

### 129-04 オンデマンドコンテンツの Intelligent Delivery

**必要なツール**

* XBOX One × 1
* XBOX One S × 1
* XBOX One X × 1
* XBOX Series X Dev Kit × 1 (XBOX Series X|S 小売コンソールモードを使用)

**テスト手順**

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

**期待される結果**

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

**合格の例**

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

**不合格の例**

1. タイトルは期待どおりにオンデマンドコンテンツをインストールしません。
2. タイトルがクラッシュしたり応答しなくなったりします。

### 129-05 Features and Recipes

**必要なツール**

* XBOX One × 1
* XBOX One S × 1
* XBOX One X × 1
* XBOX Series X Dev Kit × 1 (XBOX Series X|S 小売コンソールモードを使用)

**テスト手順**

1. Features and Recipes に関連するオプションコンテンツを含まない、ベースタイトルをインストールします。
2. タイトルのすべてのエリアに移動し、インストールされていないコンテンツにアクセスしようとして、タイトルが安定した状態を維持することを確認します。
3. システム UI で公開されている各 Feature について、Feature をインストールし、タイトル内でアクセスしようとして、タイトルが安定した状態を維持することを確認します。
4. システム UI で公開されていない各 Feature について、タイトル内の UI オプションから Feature ビューをインストールし、タイトルが安定した状態を維持することを確認します。
5. 各 Recipe について、ユーザーが関連するストアの権利を所有していることを確認し、新規インストールを実行します。
6. Recipe に含まれる Features がインストールされ、タイトル内でアクセス可能であることを確認します。

**期待される結果**

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

**合格の例**

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

**不合格の例**

1. オプションコンテンツがインストールされていないとき、タイトルがクラッシュしたり応答しなくなったりします。
2. オプションコンテンツがインストールされているとき、タイトルがそれへのアクセスを許可しません。


## Related topics

- [FMA: XR-129 Intelligent Delivery のコンテンツ管理](/ja-jp/publishing/certification/fma/xr-129.md)
- [Intelligent Delivery: OnDemand コンテンツ](/ja-jp/build/core-features/common/packaging/intelligentdelivery-ondemand.md)
- [Intelligent Delivery](/ja-jp/build/core-features/common/packaging/overviews/intelligentdelivery.md)
- [Intelligent Delivery: カスタムタグ指定子](/ja-jp/build/core-features/common/packaging/intelligentdelivery-custom.md)
- [Intelligent Delivery: Feature と Recipe](/ja-jp/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)