XPackageChunkSelector
Define los criterios para seleccionar un conjunto de fragmentos.Sintaxis
Miembros
typeTipo: XPackageChunkSelectorType El tipo del selector. language
Tipo: const char* El atributo de idioma con el que se debe coincidir, como “en-US” inglés (Estados Unidos) o “fr-FR” francés (Francia). tag
Tipo: const char* Un atributo de etiqueta con el que se debe coincidir, como BigMap o SmallMap. feature
Tipo: const char* La característica con la que se debe coincidir, como “BigMaps”. chunkId
Tipo: uint32_t El número de fragmento con el que se debe coincidir.
Comentarios
Se usa una matriz de objetosXPackageChunkSelector para seleccionar un conjunto de fragmentos en muchas operaciones de la API de instalación. En esta sección se describen las reglas que se usan para transformar una matriz de objetos XPackageChunkSelector en un conjunto de identificadores de fragmentos. Cada XPackageChunkSelector tiene un tipo de selector y un valor de selector. Un fragmento se incluye si todos los especificadores de fragmento definidos en el fragmento coinciden con todos los selectores de instalación.
Los paquetes contienen todos los archivos que componen un juego. Los archivos se pueden agrupar en unidades lógicas denominadas fragmentos. Un fragmento tiene un identificador numérico y también puede tener cero o más atributos textuales, como un idioma o una etiqueta definida por el usuario. Muchas API de XPackage operan sobre grupos de fragmentos. Estas API usan una matriz de XPackageChunkSelectors para describir qué fragmentos usará la API. En esta sección se describen las reglas que se usan para transformar una matriz de objetos XPackageChunkSelector en una matriz de identificadores de fragmentos. Cada XPackageChunkSelector tiene un tipo de selector y un valor de selector. Un fragmento se incluye si todos los atributos definidos en el fragmento coinciden con todos los selectores de fragmentos.
En la tabla siguiente, la matriz de selectores de fragmentos tiene dos selectores: idioma y una etiqueta.
La tabla siguiente es un ejemplo de definición de un conjunto de fragmentos con varios atributos.
En referencia a la tabla anterior, los fragmentos seleccionados por la matriz de selectores de fragmentos usan los atributos de fragmento 1, 2 y 5. Los fragmentos que no son seleccionados por el selector de fragmentos usan los atributos de fragmento 3, 4 y 6.
Para dar cierta perspectiva a este ejemplo de matriz de fragmentos:
- Un tipo de selector de fragmentos se compara con un atributo de fragmento solo si ese especificador está definido en el fragmento. Los fragmentos 1 a 3 no tienen ninguna etiqueta definida, por lo que el selector de fragmentos con un tipo de etiqueta se omite para estos fragmentos.
- Un fragmento puede definir más de un valor para un atributo separando varios valores con puntos y comas. Solo es necesario que coincida un valor.
- Si se rechaza algún tipo de selector de fragmentos, el fragmento se rechaza sin importar cuántos otros selectores coincidieran. El fragmento 6 se rechaza porque SmallMap no coincide con BigMap, aunque el idioma sí coincide.
Devices a un fragmento para que esté disponible solo en un conjunto determinado de consolas. Los fragmentos que seleccione se incluirán solo si también coinciden con los atributos del sistema. Si desea instalar alemán pero su paquete tiene un fragmento en alemán disponible solo en consolas XBOX One X, el monitor de instalación no incluirá este fragmento en su supervisión en una consola XBOX One. Si lo hiciera, la instalación para alemán no se completaría.
Para obtener información sobre la tecnología de empaquetado que se usa con los títulos de XBOX One, consulte Información general sobre el empaquetado. Para obtener información sobre los pasos para crear un paquete XVC, consulte Introducción al empaquetado de títulos para consolas XBOX.
Requisitos
Encabezado: XPackage.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
- Entrega inteligente: especificadores de etiquetas personalizadas
- Entrega inteligente: características y recetas
- Entrega inteligente: especificadores de idioma
Consulte también
Instalación de streaming y entrega inteligenteXPackage