Skip to main content
Cette rubrique explique comment utiliser les fonctionnalités et les recettes pour améliorer les temps d’installation initiale et ultérieure de votre jeu pour un 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 lors de l’installation initiale, ainsi que plus tard depuis le 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é aux développeurs. 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. Lors de l’installation et de la mise à jour, le système recherche toutes les balises référencées par les fonctionnalités installées, puis 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 plusieurs attributs de balise, séparés par des points-virgules. Un bloc est inclus pour l’installation si l’une de ses balises est incluse par une fonctionnalité active. Le symbole # installe une balise si les balises situées des deux côtés du # sont actives.

Localisation des noms d’affichage des fonctionnalités

La localisation des DisplayNames s’effectue de la même manière que celle des attributs de nom dans le fichier MicrosoftGame.config. Elle se fait à l’aide du format ms-resource:name, ainsi que des fichiers .resw situés 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 manière appropriée. Pour plus d’informations, 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 inclut tout contenu référencé par Intelligent Delivery pendant le développement, avant la divulgation publique de votre titre, ou tout contenu spécifique présent dans votre titre.

Fonctionnalités masquées

Les fonctionnalités marquées comme masquées empêchent les utilisateurs de choisir 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 au sein de 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 compte. Si votre fonctionnalité contient du contenu propre à un appareil ou à une langue, elle renverra 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 attribuer aux trois blocs 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 de l’API

Voir aussi

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