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 » anglais (États-Unis) ou « fr-FR » français (France). tag
Type : const char* Attribut d’étiquette à 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 sert à 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’identificateurs 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 identificateur numérique et peut également avoir zéro ou plusieurs attributs textuels, comme une langue ou une étiquette définie par l’utilisateur. De nombreuses API XPackage fonctionnent 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’identificateurs 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 étiquette.
Le tableau suivant présente un exemple de définition d’un ensemble de blocs avec divers attributs.
Selon 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 bloc 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 étiquette définie; le sélecteur de bloc de type étiquette 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 bloc quelconque est rejeté, le bloc est rejeté, quel que soit le nombre d’autres sélecteurs qui correspondent. Le bloc 6 est rejeté parce que SmallMap ne correspond pas à BigMap, même si la langue correspond.
Devices à un bloc pour le rendre disponible uniquement sur un ensemble particulier de consoles. Les blocs que vous sélectionnez ne seront 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 Bien démarrer avec 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 d’étiquettes personnalisés
- Intelligent Delivery : fonctionnalités et recettes
- Intelligent Delivery : spécificateurs de langue
Voir aussi
Installation en continu et Intelligent DeliveryXPackage