XPackageChunkSelector
定義選取一組區塊的準則。語法
成員
type類型：XPackageChunkSelectorType 選取器的類型。 language
類型：const char* 要比對的語言屬性，例如 “en-US” 英文 (美國) 或 “fr-FR” 法文 (法國)。 tag
類型：const char* 要比對的標記屬性，例如 BigMap 或 SmallMap。 feature
類型：const char* 要比對的功能，例如 “BigMaps”。 chunkId
類型：uint32_t 要比對的區塊編號。
備註
在安裝 API 的許多作業中，會使用XPackageChunkSelector 物件陣列來選取一組區塊。本節說明將 XPackageChunkSelector 物件陣列轉換為一組區塊識別碼時所使用的規則。每個 XPackageChunkSelector 都有選取器類型和選取器值。如果區塊上定義的所有區塊指定元都符合所有安裝選取器，該區塊就會被包含在內。
套件包含組成遊戲的所有檔案。檔案可以分組為稱為區塊的邏輯單位。區塊有數值識別碼，也可以有零個或多個文字屬性，例如語言或使用者定義的標記。許多 XPackage API 會針對區塊群組進行操作。這些 API 會使用 XPackageChunkSelectors 陣列來描述 API 將使用哪些區塊。本節說明將 XPackageChunkSelector 物件陣列轉換為區塊識別碼陣列時所使用的規則。每個 XPackageChunkSelector 都有選取器類型和選取器值。如果區塊上定義的所有屬性都符合所有區塊選取器，該區塊就會被包含在內。
在下表中，區塊選取器陣列有兩個選取器：語言和標記。
下表是定義一組具有各種屬性之區塊的範例。
參考上表，區塊選取器陣列所選取的區塊使用區塊屬性 1、2 和 5。未被區塊選取器選取的區塊使用區塊屬性 3、4 和 6。
為了更清楚說明此區塊陣列範例：
- 只有在區塊上定義了某個指定元時，區塊選取器類型才會與該區塊屬性進行比對。區塊 1 - 3 沒有定義標記，因此這些區塊會忽略類型為標記的區塊選取器。
- 區塊可以使用分號分隔多個值，為一個屬性定義多個值。只需要符合其中一個值即可。
- 如果任何區塊選取器類型遭到拒絕，無論有多少其他選取器符合，該區塊都會遭到拒絕。區塊 6 遭到拒絕，因為 SmallMap 不符合 BigMap，即使語言相符也一樣。
Devices 屬性新增至區塊，讓它僅在特定的一組主機上可用。只有在您選取的區塊也符合系統屬性時，才會包含這些區塊。如果您想要安裝德文，但您的套件具有僅在 XBOX One X 主機上可用的德文區塊，則在 XBOX One 主機上，安裝監視器不會將此區塊納入其監視範圍。如果納入的話，德文的安裝將永遠無法完成。
如需 XBOX One 遊戲所使用之封裝技術的相關資訊，請參閱封裝概觀。如需建立 XVC 套件之步驟的相關資訊，請參閱開始為 XBOX 主機封裝遊戲。
需求
標頭： XPackage.h 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
串流安裝和 Intelligent DeliveryXPackage