Avant de commencer
- Un compte Partner Center configuré pour développer des jeux XBOX, contenant un jeu. Les tests de jeu ne nécessitent aucune demande d’accès distincte.
- Des classifications par âge pour le jeu. Remplissez une fois le questionnaire de l’International Age Rating Coalition (IARC), sur la page Classifications par âge du jeu dans Partner Center. Un test de jeu ne peut pas être publié sans elles.
- L’autorisation de gérer les packages du jeu dans Partner Center. Sans elle, les commandes
packageetplaytestéchouent avec l’erreur 403package_permission_denied. Demandez-la à un responsable de votre compte Partner Center, ou passez--seller-idsi le jeu appartient à un autre vendeur. - Connectez-vous avec
xbox auth loginet choisissez un vendeur, comme dans Prise en main.
9N0000000000. Trouvez le Store ID de votre jeu avec
xbox game list --output table.
1. Charger un package
La CLI ne charge pas de packages. Chargez le build avecmakepkg à partir du XBOX Game Development Kit (GDK)
d’octobre 2026 ou d’une version ultérieure. Pour un jeu PC dont le build se trouve dans le dossier layout :
STATE vaut Processed et PLAYTEST vaut true. Notez son PACKAGE ID.
Le tableau n’affiche pas les résultats de validation : vérifiez donc en JSON que ses validationItems ne contiennent aucun
élément de gravité Error :
STATE vaut ProcessFailed, si PLAYTEST reste à false ou s’il existe un élément Error, consultez les
exigences relatives aux packages dans Conditions préalables pour un test de jeu.
2. Créer une audience
Une audience détermine qui peut installer le test de jeu. Partner Center l’appelle un groupe de clients. Dans l’espace de travail Applications et jeux de Partner Center, sélectionnez Groupes de clients, puis Créer un groupe. Choisissez Groupe d’utilisateurs connus, ajoutez vos testeurs et enregistrez le groupe. Vous pouvez aussi répertorier les adresses e-mail de vos testeurs danstesters.txt, une par ligne, et créer l’audience avec la
commande expérimentale audience create :
id de l’audience pour l’ajouter au test de jeu.
3. Créer le test de jeu
Si vous avez créé l’audience avecaudience create, utilisez l’id affiché. Si vous avez créé le
groupe dans Partner Center, trouvez son ID :
xbox audience list expire, ce qui est un problème connu,
omettez --audience-id lorsque vous créez le test de jeu. Ensuite, dans Partner Center, ouvrez le
test de jeu depuis la page Playtest du jeu sous Services, choisissez le groupe de l’étape 2 et enregistrez
sans publier.
Créez le test de jeu :
--pc-package-idprend l’ID de package de l’étape 1. Utilisez--console-package-idpour un package console.--audience-idprend l’ID de l’audience. Répétez cette option pour ajouter d’autres audiences.- Les testeurs peuvent installer le test de jeu de
--startjusqu’à--end. Une date sans heure correspond à minuit UTC.
playtestId sous details.
Si la commande se termine avec 3, elle n’a pas pu déterminer si le test de jeu a été créé. Réessayez avec la
commande qu’elle affiche, qui ne créera pas de second test de jeu.
4. Le publier
Publiez le test de jeu avec l’ID de l’étape 3 :Live, ou Scheduled si sa date de début n’est pas encore arrivée,
puis se termine avec 0. Les autres codes de sortie signifient que le test de jeu n’est pas encore publié :
Consultez Publication d’un test de jeu.
5. Le partager
Une fois le test de jeu actif, les testeurs de son audience peuvent le trouver dans leur bibliothèque :- Sur une console, dans Bibliothèque complète, sous le filtre Playtest.
- Sur un PC, dans la Bibliothèque de l’application XBOX, sous le filtre Accès.
msxbox://playtest/. La CLI ne peut pas encore
afficher ce lien. Il ne fonctionne que pour les personnes de l’audience du test de jeu et, sur un PC, il ouvre le
test de jeu dans l’application XBOX. Consultez
Partager un test de jeu avec les testeurs.
Scripts et intégration continue
Vous pouvez charger des packages depuis des pipelines d’intégration continue (CI) avec un principal de service. Consultez Chargement de packages. Les commandesxbox package et
xbox playtest n’acceptent pas encore de principal de service : elles nécessitent donc un utilisateur connecté. Consultez
Authentification pour l’automatisation (principal de service).
Dans un script qui s’exécute pendant que vous êtes connecté, passez --confirm à playtest create et
playtest publish, car sans terminal, elles ne peuvent pas vous demander confirmation et n’effectuent aucune modification. Lisez le
JSON qu’elles affichent et vérifiez leurs codes de sortie. Pour attendre plus de 5 minutes une publication, passez
--timeout.