Skip to main content
Cette rubrique décrit comment utiliser les fonctionnalités et les recettes pour améliorer les temps d’installation initiale et subséquente de votre jeu pour l’utilisateur. Les fonctionnalités et les recettes fonctionnent ensemble pour définir des groupes de contenu au sein de votre jeu de base que les utilisateurs peuvent ajouter et supprimer pendant l’installation initiale, ainsi que plus tard à partir de l’interpréteur de commandes (shell). Vous pouvez également utiliser des API d’exécution pour interroger dynamiquement l’état d’installation des fonctionnalités et déclencher l’ajout et la suppression de fonctionnalités. Une fonctionnalité est un élément XML qui spécifie un attribut de chaîne d’ID destiné au développeur. Elle spécifie également le nom d’affichage localisable et l’image destinés à l’utilisateur, à afficher dans le shell. La fonctionnalité spécifie une ou plusieurs balises. Au moment de l’installation et de la mise à jour, le système trouve toutes les balises référencées par les fonctionnalités installées et installe tous les blocs qui contiennent ces balises. Une recette est un élément XML qui spécifie une liste de fonctionnalités à installer. Il existe toujours une recette par défaut, et les fonctionnalités incluses dans cette recette sont toujours installées. Des recettes supplémentaires peuvent être définies. Elles sont activées au moment de l’installation si l’utilisateur ou la console actuelle dispose d’un droit d’utilisation pour l’un des StoreIds spécifiés, comme le montre le code suivant.
Les fonctionnalités peuvent contenir plus d’un attribut de balise, séparés par des points-virgules. Un bloc est inclus pour l’installation si l’une des balises du bloc est incluse par une fonctionnalité active. Le symbole # installe une balise si les balises des deux côtés du # sont actives.

Localisation des noms d’affichage des fonctionnalités

La localisation des DisplayNames se fait de la même façon que la localisation des attributs de nom dans le fichier MicrosoftGame.config. Elle se fait à l’aide du format ms-resource:name, ainsi que des fichiers .resw qui se trouvent dans le répertoire strings de votre jeu, et des chaînes propres à chaque paramètre régional dans des sous-répertoires nommés de façon appropriée. Pour plus d’information, consultez Localisation de MicrosoftGame.Config
Les valeurs de chaînes localisées et les images utilisées avec MicrosoftGame.config et Intelligent Delivery ne sont pas chiffrées dans les packages publiés, ni dans les sandbox de développement ni en version commerciale. Utilisez des valeurs d’espace réservé dans votre jeu pour le titre, les icônes et tout contenu sensible. Le contenu sensible comprend tout contenu référencé par Intelligent Delivery pendant le développement, avant la divulgation publique de votre titre, ou du contenu précis qui se trouve dans votre titre.

Fonctionnalités masquées

Les fonctionnalités sont marquées comme masquées, ce qui empêche les utilisateurs de décider si elles sont affichées comme options sélectionnables au moment de l’installation, ou lors de la gestion dans le shell après l’installation de votre titre. Soyez prudent lorsque vous utilisez des fonctionnalités masquées, car la seule façon de les ajouter ou de les supprimer est d’utiliser des API dans votre titre. Tout bogue découvert dans votre titre pourrait rendre du contenu inaccessible jusqu’à ce que vous fournissiez une mise à jour de contenu pour corriger ces bogues. Le code suivant est un exemple de fonctionnalité marquée comme masquée.

Vérification de l’état d’installation des fonctionnalités

Vous pouvez utiliser les fonctionnalités pour vérifier la présence de tous les blocs dont les balises sont spécifiées par cette fonctionnalité. Lors de ces requêtes d’exécution, les spécificateurs d’appareil et de langue sont pris en considération. Si votre fonctionnalité contient du contenu propre à un appareil ou à une langue, elle retournera tout de même true tant qu’une langue, ainsi que tous les blocs de cette fonctionnalité applicables à l’appareil actuel, sont installés. Par exemple, si les ressources de la fonctionnalité Campaign sont contenues dans les blocs 8000, 8001 et 8002, au lieu d’appeler la méthode XPackageFindChunkAvailability pour déterminer si cet ensemble de blocs est entièrement installé et jouable, vous pouvez marquer les trois blocs avec la balise personnalisée « campaign1 », puis référencer « campaign1 » dans votre fonctionnalité Campaign. Vous pouvez ensuite appeler la méthode XPackageFindChunkAvailability en utilisant XPackageChunkSelector avec l’ID de la fonctionnalité Campaign pour obtenir facilement l’état d’installation de cet ensemble de données.

Documentation de référence des API

Voir aussi

Présentation d’Intelligent Delivery XPackageChunkSelector XPackageInstallChunks Localisation de MicrosoftGame.Config
Last modified on October 6, 2026