XPackageChunkSelector
Define os critérios para selecionar um conjunto de partes.Sintaxe
Membros
typeTipo: XPackageChunkSelectorType O tipo do seletor. language
Tipo: const char* O atributo de idioma a ser correspondido, como “en-US” inglês (Estados Unidos) ou “fr-FR” francês (França). tag
Tipo: const char* Um atributo de marca a ser correspondido, como BigMap ou SmallMap. feature
Tipo: const char* O recurso a ser correspondido, como “BigMaps”. chunkId
Tipo: uint32_t O número da parte a ser correspondido.
Comentários
Uma matriz de objetosXPackageChunkSelector é usada para selecionar um conjunto de partes para muitas operações na API de instalação. Esta seção descreve as regras usadas para transformar uma matriz de objetos XPackageChunkSelector em um conjunto de IDs de partes. Cada XPackageChunkSelector tem um tipo de seletor e um valor de seletor. Uma parte será incluída se todos os especificadores de parte definidos nela corresponderem a todos os seletores de instalação.
Os pacotes contêm todos os arquivos que compõem um jogo. Os arquivos podem ser agrupados em unidades lógicas chamadas partes. Uma parte tem uma ID numérica e também pode ter zero ou mais atributos textuais, como um idioma ou uma marca definida pelo usuário. Muitas APIs de XPackage operam em grupos de partes. Essas APIs usam uma matriz de XPackageChunkSelectors para descrever quais partes a API usará. Esta seção descreve as regras usadas para transformar uma matriz de objetos XPackageChunkSelector em uma matriz de IDs de partes. Cada XPackageChunkSelector tem um tipo de seletor e um valor de seletor. Uma parte será incluída se todos os atributos definidos nela corresponderem a todos os seletores de partes.
Na tabela a seguir, a matriz de seletores de partes tem dois seletores: idioma e uma marca.
A tabela a seguir é um exemplo de definição de um conjunto de partes com vários atributos.
Com base na tabela anterior, as partes selecionadas pela matriz de seletores de partes usam os atributos de parte 1, 2 e 5. As partes que não são selecionadas pelo seletor de partes usam os atributos de parte 3, 4 e 6.
Para dar alguma perspectiva a este exemplo de matriz de partes:
- Um tipo de seletor de parte é correspondido com um atributo de parte somente se esse especificador estiver definido na parte. As partes 1 a 3 não têm marca definida, portanto, o seletor de partes do tipo marca é ignorado para essas partes.
- Uma parte pode definir mais de um valor para um atributo separando vários valores com ponto e vírgula. Apenas um valor precisa corresponder.
- Se qualquer tipo de seletor de parte for rejeitado, a parte será rejeitada, independentemente de quantos outros seletores corresponderam. A parte 6 é rejeitada porque SmallMap não corresponde a BigMap, embora o idioma corresponda.
Devices a uma parte para torná-la disponível somente em um determinado conjunto de consoles. As partes selecionadas serão incluídas somente se também corresponderem aos atributos do sistema. Se você quiser instalar o alemão, mas seu pacote tiver uma parte em alemão disponível somente em consoles XBOX One X, o monitor de instalação não incluirá essa parte em seu monitoramento em um console XBOX One. Se incluísse, a instalação do alemão não seria concluída.
Para obter informações sobre a tecnologia de empacotamento usada com títulos do XBOX One, consulte Visão geral do empacotamento. Para obter informações sobre as etapas para criar um pacote XVC, consulte Introdução ao empacotamento de títulos para consoles XBOX.
Requisitos
Cabeçalho: XPackage.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Intelligent Delivery: especificadores de marca personalizados
- Intelligent Delivery: recursos e receitas
- Intelligent Delivery: especificadores de idioma
Confira também
Instalação por streaming e Intelligent DeliveryXPackage