Skip to main content
このトピックでは、ゲームの初回およびその後のインストール時間を改善するために、Feature と Recipe を使用する方法について説明します。Feature と Recipe は共に、ユーザーが初回インストール時、およびその後シェル内から追加および削除できる、ベースゲーム内のコンテンツグループを定義します。実行時 API を使用して、Feature のインストール状態を動的にクエリし、Feature の追加と削除をトリガーすることもできます。 Feature は、開発者向けの ID 文字列属性を指定する XML 要素です。シェルで表示するためのユーザー向けのローカライズ可能な表示名と画像も指定します。Feature は 1 つ以上のタグを指定します。インストールおよび更新時に、システムはインストール済み Feature によって参照されるすべてのタグを見つけ、それらのタグを含むすべてのチャンクをインストールします。 Recipe は、インストールすべき Feature のリストを指定する XML 要素です。常に既定の Recipe があり、Recipe が含む Feature は常にインストールされます。追加の Recipe を定義できます。それらは、次のコードに示すように、ユーザーまたは現在のコンソールが指定された任意の StoreIds に対するエンタイトルメントを持っている場合、インストール時にアクティブになります。
Feature は複数のタグ属性を含むことができ、セミコロンで区切ります。チャンク内のいずれかのタグがアクティブな Feature に含まれていれば、そのチャンクはインストール対象に含まれます。# 記号は、# の両側のタグが共にアクティブな場合にタグをインストールします。

Feature 表示名のローカライズ

DisplayNames のローカライズは、MicrosoftGame.config ファイル内の name 属性のローカライズと同じ方法で行われます。これは、ms-resource:name 形式を、ゲームの strings ディレクトリ内の .resw ファイルおよび適切に名前が付けられたサブディレクトリ内のロケール別文字列と共に使用することで行われます。詳細については、MicrosoftGame.Config のローカライズ を参照してください。
MicrosoftGame.config および Intelligent Delivery で使用されるローカライズされた文字列値および画像は、開発者サンドボックスでも小売でも、公開されたパッケージ内で暗号化されません。タイトル、アイコン、その他機密性の高いコンテンツにはゲーム内でプレースホルダー値を使用してください。機密性の高いコンテンツには、開発中、タイトルの公開開示前、またはタイトル内で見つかる特定のコンテンツで Intelligent Delivery が参照するコンテンツが含まれます。

非表示の Feature

Feature を非表示としてマークすることで、インストール時、またはタイトルがインストールされた後のシェル管理時に、ユーザーがそれらを選択可能なオプションとして表示するかどうかを決定することを防ぎます。非表示の Feature を使用する際は注意が必要です。それらを追加または削除する唯一の方法は、タイトル内の API を使用することだからです。タイトルで発見されたバグは、それらを修正するコンテンツ更新を提供するまで、アクセス不可能なコンテンツをもたらす可能性があります。次のコードは、非表示としてマークされた Feature の例です。

Feature のインストールステータスの確認

Feature を使用して、その Feature で指定されたタグを持つすべてのチャンクの存在を確認できます。これらの実行時クエリを実行する場合、Device および Language 指定子が考慮されます。Feature 内にデバイスまたは言語固有のコンテンツがある場合、1 つの言語と、その Feature 内の現在のデバイスに適用可能なすべてのチャンクがインストールされている限り、true として返されます。 たとえば、Campaign Feature のアセットがチャンク 8000、8001、8002 に含まれている場合、そのチャンクセットが完全にインストールされプレイ可能かどうかを判断するために XPackageFindChunkAvailability メソッドを呼び出す代わりに、3 つのチャンクすべてにカスタムタグ「campaign1」を付け、Campaign Feature で「campaign1」を参照できます。次に、Campaign Feature ID を持つ XPackageChunkSelector を使用して XPackageFindChunkAvailability メソッドを呼び出すことで、そのデータセットのインストールステータスを簡単に取得できます。

リファレンス API ドキュメント

関連項目

Intelligent Delivery の概要 XPackageChunkSelector XPackageInstallChunks MicrosoftGame.Config のローカライズ
最終更新日 2026年8月13日