XPackageChunkSelector
チャンクのセットを選択するための条件を定義します。Syntax
Members
type型: XPackageChunkSelectorType セレクターの種類。 language
型: const char* 一致させる言語属性。たとえば、“en-US” (英語 (米国)) や “fr-FR” (フランス語 (フランス)) など。 tag
型: const char* 一致させるタグ属性。たとえば、BigMap や SmallMap など。 feature
型: const char* 一致させる機能。たとえば、“BigMaps” など。 chunkId
型: uint32_t 一致させるチャンク番号。
Remarks
XPackageChunkSelector オブジェクトの配列は、インストール API の多くの操作でチャンクのセットを選択するために使用されます。このセクションでは、XPackageChunkSelector オブジェクトの配列をチャンク ID のセットに変換するために使用されるルールについて説明します。各 XPackageChunkSelector にはセレクター タイプとセレクター値があります。チャンクは、そのチャンクに定義されているすべてのチャンク指定子がすべてのインストール セレクターに一致する場合に含まれます。
パッケージには、ゲームを構成するすべてのファイルが含まれます。ファイルはチャンクと呼ばれる論理ユニットにグループ化できます。チャンクには数値 ID があり、言語やユーザー定義のタグなどの 0 個以上のテキスト属性を持つこともあります。多くの XPackage API はチャンクのグループに対して動作します。これらの API は、XPackageChunkSelectors の配列を使用して、API が使用するチャンクを記述します。このセクションでは、XPackageChunkSelector オブジェクトの配列をチャンク ID の配列に変換するために使用されるルールについて説明します。各 XPackageChunkSelector にはセレクター タイプとセレクター値があります。チャンクは、そのチャンクに定義されているすべての属性がすべてのチャンク セレクターに一致する場合に含まれます。
次の表では、チャンク セレクター配列に 2 つのセレクター、language と tag があります。
次の表は、さまざまな属性を持つチャンクのセットを定義する例です。
前述の表を参照すると、チャンク セレクター配列によって選択されるチャンクはチャンク属性 1、2、5 を使用します。チャンク セレクターによって選択されないチャンクはチャンク属性 3、4、6 を使用します。
このチャンク配列の例に関する補足:
- チャンク セレクター タイプは、その指定子がチャンクに定義されている場合にのみチャンク属性と照合されます。チャンク 1 ～ 3 にはタグが定義されていないため、これらのチャンクに対してタイプが tag のチャンク セレクターは無視されます。
- チャンクは、複数の値をセミコロンで区切ることで、1 つの属性に複数の値を定義できます。一致するのは 1 つの値だけで構いません。
- いずれかのチャンク セレクター タイプが拒否された場合、他のセレクターがいくつ一致してもチャンクは拒否されます。チャンク 6 は言語は一致しますが、SmallMap が BigMap に一致しないため拒否されます。
Devices 属性を追加して、特定の本体セットでのみ利用可能にすることができます。選択したチャンクは、システム属性にも一致する場合にのみ含まれます。ドイツ語をインストールしようとしていて、パッケージのドイツ語チャンクが XBOX One X 本体でのみ利用可能な場合、XBOX One 本体上ではインストール モニターはこのチャンクを監視の対象に含めません。含めた場合、ドイツ語のインストールは完了しません。
XBOX One タイトルで使用されるパッケージ技術については、パッケージ化の概要 を参照してください。XVC パッケージを作成する手順については、XBOX 本体用にタイトルをパッケージ化する開始方法 を参照してください。
Requirements
ヘッダー: XPackage.h サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
ストリーミング インストールとインテリジェント デリバリーXPackage