> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Activation des tests de licence > Configurez une build de développement XBOX pouvant faire l'objet d'une licence pour tester les API de licence XStore, y compris les scénarios pertinents et les étapes de configuration requises dans Partner. Cet article explique comment configurer une build de développement pour qu'elle puisse faire l'objet d'une licence, afin de tester les scénarios liés aux licences. ## Scénarios et API pertinents Pour tester les API suivantes, vous devez configurer votre environnement de développement comme décrit dans cet article : | API | Utilisation | | - | - | | [XStoreQueryGameLicenseAsync](/fr/reference/system/xstore/xstore_members) | Interrogation des caractéristiques d'une licence d'évaluation ou sur disque pour le jeu. | | [XStoreQueryLicenseTokenAsync](/fr/reference/system/xstore/xstore_members) | Génération d'un jeton de licence valide pour la validation par un service ; consultez [Utilisation des jetons de licence](/fr/publishing/xstore-commerce/xstore-license-tokens). | | [XStoreQueryAddOnLicensesAsync](/fr/reference/system/xstore/xstore_members) | Renvoi des licences de modules complémentaires (biens durables sans package) associées à une licence de jeu numérique. | | [XStoreRegisterGameLicenseChanged](/fr/reference/system/xstore/xstore_members) | Inscription pour détecter un changement de licence (par exemple, lorsqu'une licence d'évaluation est mise à niveau vers une licence complète). | ## Contexte Dans les scénarios commerciaux, un jeu doit disposer d'une licence pour pouvoir être joué. Une demande de licence vérifie la présence d'un disque inséré ou envoie une requête aux services Microsoft. Une licence est accordée si le compte a droit au produit grâce à un achat direct ou satisfaisant (par exemple, via un abonnement ou une offre groupée). Des licences peuvent également être accordées dans des scénarios de partage. Pour plus d'informations sur le partage, consultez [Modèle de partage de produits pour les jeux](/fr/publishing/xstore-commerce/xstore-product-sharing). Les scénarios de développement ne suivent pas ce comportement par défaut. Ces scénarios incluent : * Les builds libres (déploiement F5 de Visual Studio, xbapp/wdapp register/deploy) * Les builds de packages locales (makepkg, xbapp/wdapp install) Ces builds se lancent sans aucune vérification de licence ni configuration associée. La plupart des API `XStore` fonctionnent toujours, mais des résultats inattendus peuvent se produire lors de l'octroi de licences pour des jeux ou des biens durables. Pour configurer une build afin qu'elle se comporte comme pouvant faire l'objet d'une licence, appliquez les valeurs d'identité correctes au fichier MicrosoftGameConfig (comme décrit dans [Activation du développement et des tests XStore](/fr/publishing/xstore-commerce/xstore-product-testing-setup)). Les étapes suivantes doivent ensuite être effectuées : 1. [Noter l'ID de contenu propre au jeu ou au DLC](#get-contentid) 2. [Appliquer l'ID de contenu à la build, selon le type de build](#apply-content-id-to-build) 3. [**Console uniquement** : noter et appliquer l'EKBID à la build](#apply-ekbid-to-build-only-applicable-to-console) Ensuite, pour chaque compte qui exécute la build, un droit d'utilisation doit être acquis en achetant le produit dans le Store approprié pour la plateforme. ## Obtenir le ContentID Vous trouverez le ContentID sur la page **Packages** après avoir sélectionné **Show details** : Page Packages dans Partner Center L'ID de contenu des versions sandbox et commerciale peut être différent. Si vous installez une version commerciale du jeu, le produit est associé à un ID de contenu différent de celui dont vous avez besoin pour le sandbox. L'ID de contenu diffère également si des packages régionaux sont impliqués. ### Console Pour trouver l'ID de contenu d'un package installé, exécutez `xbapp list /d` (ou `xbapp listdlc /d` pour un DLC) dans l'invite de commandes Gaming Command Prompt. ```cmd theme={null} Registered Applications by Package Full Name: 41336MicrosoftATG.InGameStoreXS_2020.7.27.0_neutral__dspnxghe87tn0 Install Drive: Development Size: 0.28 GB. ContentId: {2797FA46-A93B-494C-AD80-B67C9FCA939F} ProductId: {4C544E39-5130-3044-C057-5A3446536A00} EKBID: {37E80840-6BE0-46F8-8EDB-92F877056087} DisplayName: ATG In-Game Store Sample 41336MicrosoftATG.InGameStoreXS_dspnxghe87tn0!Game ``` ### PC Pour trouver l'ID de contenu d'un package installé, exécutez `wdapp list /d` (ou `wdapp listdlc /d` pour un DLC) dans l'invite de commandes Gaming Command Prompt. Pour les packages que vous installez depuis le Store, utilisez l'indicateur `/includeStore`. ## Appliquer l'ID de contenu à la build Pour les builds libres, ajoutez la section suivante dans MicrosoftGameConfig : ```xml theme={null} 2797FA46-A93B-494C-AD80-B67C9FCA939F 00000000-0000-0000-0000-000000000001 ``` Pour les builds de packages, transmettez l'ID de contenu à `makepkg`. Par exemple : ```cmd theme={null} makepkg pack /v /f chunks.xml /d Gaming.Xbox.XboxOne.x64\Layout\Image\Loose /pd ./output /contentid 2797FA46-A93B-494C-AD80-B67C9FCA939F ``` Si vous créez un package sans le paramètre `/contentid`, le processus d'installation applique tout `ContentIdOverride` disponible dans MicrosoftGameConfig lorsque vous installez à partir d'une source locale. Les builds installées depuis le Store (sandbox ou commerciale) disposent toujours de l'ID de contenu approprié (tel qu'il apparaît dans Partner Center). ## Appliquer l'EKBID à la build (console uniquement) Définissez l'EKBID (Escrow Key Blob ID) pour que la build puisse faire l'objet d'une licence sur console. Dans la plupart des scénarios, il suffit de le remplacer par rapport à la valeur de test par défaut, composée uniquement de zéros, ou 33EC8436-5A0E-4F0D-B1CE-3F29C3955039. Remplacez l'EKBID à l'aide de la commande suivante : ```cmd theme={null} xbapp setekbid {} ``` Par exemple : ```cmd theme={null} xbapp setekbid 41336MicrosoftATG.InGameStoreXS_2020.7.27.0_neutral__dspnxghe87tn0 {00000000-0000-0000-0000-000000000001} ``` Ce paramètre n'est pas pertinent sur PC (il n'existe pas de commande `wdapp setekbid`). ### Versions d'évaluation et EKBID Pour les **versions d'évaluation**, l'EKBID réel doit être appliqué. Pour trouver l'EKBID utilisé par le jeu, exécutez `xbapp list /d` pour une build installée depuis le Store. Pour plus d'informations, consultez [Implémentation de versions d'évaluation pour votre jeu](/fr/publishing/xstore-commerce/xstore-trials). ## S'assurer que le compte de test a droit au produit dans le sandbox Pour les produits publiés à la fois dans le sandbox et en version commerciale, vous pouvez utiliser DevEntitlementTool pour interroger et acquérir des droits d'utilisation pour un compte de test. Le meilleur moyen d'obtenir un droit d'utilisation consiste à accéder directement à la page Store du produit par activation de protocole, car les produits publiés uniquement dans le sandbox peuvent ne pas être trouvables par recherche. La console ou le PC de développement doit être défini sur le sandbox dans lequel le jeu est publié. Pour plus d'informations, consultez la documentation de vue d'ensemble des sandbox des XBOX services et, pour PC, consultez [Changer correctement de sandbox pour les opérations du Store](/fr/publishing/xstore-commerce/xstore-switching-sandbox). Une fois correctement connecté, utilisez le lien de protocole du Store pour accéder à la page Store : **Sur console :** Utilisez Gaming Command Prompt : `xbapp launch ms-windows-store://pdp/?productid=` **Sur PC :** Dans la boîte de dialogue Exécuter (⊞Win +R) ou dans un navigateur web `msxbox://game/?productId=` (pour afficher le produit dans l'application XBOX) Ou `ms-windows-store://pdp/?productid=` (pour afficher le produit dans le Microsoft Store) Une fois sur la page Store, sélectionnez **Acheter** ou **Obtenir** pour acquérir une licence du produit pour votre compte de test. Le téléchargement et l'installation des jeux et des DLC devraient démarrer automatiquement. Si vous prévoyez d'itérer avec des builds locales, vous pouvez annuler l'opération. Vous devez acquérir un droit d'utilisation pour chaque compte qui exécute la build et qui s'attend à ce que les API XStore liées aux licences fonctionnent. ## DLC Pour qu'un DLC local puisse faire l'objet d'une licence, l'ID de contenu doit être appliqué à `makepkg` et `xbapp setekbid` doit être défini sur une valeur autre que les valeurs par défaut. Seul le DLC doit être configuré pour les licences, pas le jeu de base. Les remplacements de licence sont pertinents pour les API suivantes lorsqu'elles sont appelées avec un bien durable avec package : * [XStoreAcquireLicenseForDurablesAsync](/fr/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForPackageAsync](/fr/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForPackageAsync](/fr/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForStoreIdAsync](/fr/reference/system/xstore/xstore_members) * [XStoreRegisterPackageLicenseLost](/fr/reference/system/xstore/xstore_members) Vous trouverez plus de détails ici : [Gérer et accorder des licences pour le contenu téléchargeable (DLC)](/fr/publishing/xstore-commerce/xstore-dlc) [Utilisation d'un bien durable sans package](/fr/publishing/xstore-commerce/xstore-dwob) ## Documentation de référence de l'API * [XStore (contenu de l'API)](/fr/reference/system/xstore/xstore_members) * Fonctions * [XStoreQueryGameLicenseAsync](/fr/reference/system/xstore/xstore_members) * [XStoreQueryLicenseTokenAsync](/fr/reference/system/xstore/xstore_members) * [XStoreQueryAddOnLicensesAsync](/fr/reference/system/xstore/xstore_members) * [XStoreRegisterGameLicenseChanged](/fr/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForDurablesAsync](/fr/reference/system/xstore/xstore_members) * [XStoreAcquireLicenseForPackageAsync](/fr/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForPackageAsync](/fr/reference/system/xstore/xstore_members) * [XStoreCanAcquireLicenseForStoreIdAsync](/fr/reference/system/xstore/xstore_members) * [XStoreRegisterPackageLicenseLost](/fr/reference/system/xstore/xstore_members) ## Voir aussi [Vue d'ensemble du commerce](/fr/publishing/xstore-commerce/xstore-commerce-overview)
[Activation du développement et des tests XStore](/fr/publishing/xstore-commerce/xstore-product-testing-setup)
[Changer correctement de sandbox pour les opérations du Store](/fr/publishing/xstore-commerce/xstore-switching-sandbox)
[Référence de l'API XStore](/fr/reference/system/xstore/xstore_members) ## Related topics - [Historique des modifications des exigences XBOX et des cas de test](/fr-CA/publishing/certification/xr-change-history.md) - [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md) - [Étapes du test de validation des supports](/fr/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md) - [Exigences de sécurité pour les titulaires de licence du GDK](/fr-CA/home/onboarding-access/security-requirements.md) - [Intégration des partenaires XBOX : accès et publication](/fr/home/onboarding.md)