XPackageChunkSelector
Définit les critères de sélection d’un ensemble de blocs.Syntaxe
Membres
typeType : XPackageChunkSelectorType Type du sélecteur. language
Type : const char* Attribut de langue à faire correspondre, par exemple « en-US » pour anglais (États-Unis) ou « fr-FR » pour français (France). tag
Type : const char* Attribut de balise à faire correspondre, par exemple BigMap ou SmallMap. feature
Type : const char* Fonctionnalité à faire correspondre, par exemple « BigMaps ». chunkId
Type : uint32_t Numéro de bloc à faire correspondre.
Remarques
Un tableau d’objetsXPackageChunkSelector permet de sélectionner un ensemble de blocs pour de nombreuses opérations de l’API d’installation. Cette section décrit les règles utilisées pour transformer un tableau d’objets XPackageChunkSelector en un ensemble d’ID de blocs. Chaque XPackageChunkSelector possède un type de sélecteur et une valeur de sélecteur. Un bloc est inclus si tous les spécificateurs de bloc définis sur le bloc correspondent à tous les sélecteurs d’installation.
Les packages contiennent tous les fichiers qui composent un jeu. Les fichiers peuvent être regroupés en unités logiques appelées blocs. Un bloc possède un ID numérique et peut également avoir zéro, un ou plusieurs attributs textuels, comme une langue ou une balise définie par l’utilisateur. De nombreuses API XPackage opèrent sur des groupes de blocs. Ces API utilisent un tableau de XPackageChunkSelectors pour décrire les blocs que l’API utilisera. Cette section décrit les règles utilisées pour transformer un tableau d’objets XPackageChunkSelector en un tableau d’ID de blocs. Chaque XPackageChunkSelector possède un type de sélecteur et une valeur de sélecteur. Un bloc est inclus si tous les attributs définis sur le bloc correspondent à tous les sélecteurs de blocs.
Dans le tableau suivant, le tableau de sélecteurs de blocs comporte deux sélecteurs : une langue et une balise.
Le tableau suivant est un exemple de définition d’un ensemble de blocs avec divers attributs.
D’après le tableau précédent, les blocs sélectionnés par le tableau de sélecteurs de blocs utilisent les attributs de bloc 1, 2 et 5. Les blocs qui ne sont pas sélectionnés par le sélecteur de blocs utilisent les attributs de bloc 3, 4 et 6.
Pour mettre cet exemple de tableau de blocs en perspective :
- Un type de sélecteur de blocs n’est mis en correspondance avec un attribut de bloc que si ce spécificateur est défini sur le bloc. Les blocs 1 à 3 n’ont aucune balise définie ; le sélecteur de blocs de type balise est donc ignoré pour ces blocs.
- Un bloc peut définir plusieurs valeurs pour un attribut en séparant les valeurs par des points-virgules. Une seule valeur doit correspondre.
- Si un type de sélecteur de blocs est rejeté, le bloc est rejeté, quel que soit le nombre d’autres sélecteurs qui correspondent. Le bloc 6 est rejeté, car SmallMap ne correspond pas à BigMap, bien que la langue corresponde.
Devices à un bloc pour le rendre disponible uniquement sur un ensemble particulier de consoles. Les blocs que vous sélectionnez ne sont inclus que s’ils correspondent également aux attributs système. Si vous souhaitez installer l’allemand mais que votre package comporte un bloc allemand disponible uniquement sur les consoles XBOX One X, le moniteur d’installation n’inclura pas ce bloc dans sa surveillance sur une console XBOX One. Sinon, l’installation de l’allemand ne se terminerait jamais.
Pour plus d’informations sur la technologie d’empaquetage utilisée avec les titres XBOX One, consultez Vue d’ensemble de l’empaquetage. Pour plus d’informations sur les étapes de création d’un package XVC, consultez Prise en main de l’empaquetage des titres pour les consoles XBOX.
Configuration requise
En-tête : XPackage.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
- Intelligent Delivery : spécificateurs de balises personnalisées
- Intelligent Delivery : fonctionnalités et recettes
- Intelligent Delivery : spécificateurs de langue
Voir aussi
Installation en streaming et Intelligent DeliveryXPackage