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 Age ratings 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 gestionnaire 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. Téléverser un package
La CLI ne téléverse pas les packages. Téléversez 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 est Processed et que PLAYTEST est true. Notez son PACKAGE ID.
Le tableau n’affiche pas les résultats de validation; vérifiez donc dans le JSON que ses validationItems ne contiennent aucun
élément de gravité Error :
STATE est ProcessFailed, si PLAYTEST reste false ou s’il y a un élément Error, vérifiez les
exigences relatives aux packages dans Prérequis d’un test de jeu.
2. Créer un public
Un public détermine qui peut installer le test de jeu. Partner Center l’appelle un groupe de clients. Dans l’espace de travail Apps and games de Partner Center, sélectionnez Customer groups, puis Create new group. Choisissez Known user group, ajoutez vos testeurs et enregistrez le groupe. Vous pouvez aussi répertorier les adresses courriel de vos testeurs danstesters.txt, une par ligne, et créer le public avec la
commande expérimentale audience create :
id du public pour pouvoir l’ajouter au test de jeu.
3. Créer le test de jeu
Si vous avez créé le public avecaudience create, utilisez l’id qu’il a affiché. Si vous avez créé le
groupe dans Partner Center, trouvez son ID :
xbox audience list expire, un problème connu,
omettez --audience-id lorsque vous créez le test de jeu. Ensuite, dans Partner Center, ouvrez le
test de jeu à partir de la page Playtest du jeu sous Services, choisissez le groupe de l’étape 2 et enregistrez-le
sans le publier.
Créez le test de jeu :
--pc-package-idprend l’ID de package de l’étape 1. Utilisez--console-package-idpour un package de console.--audience-idprend l’ID du public. Répétez-la pour ajouter d’autres publics.- 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 le code 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 deuxième 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,
et se termine avec le code 0. Les autres codes de sortie signifient que le test de jeu n’est pas encore publié :
Consultez Publier un test de jeu.
5. Le partager
Une fois le test de jeu en ligne, les testeurs de son public peuvent le trouver dans leur bibliothèque :- Sur une console, dans Full Library, sous le filtre Playtest.
- Sur un PC, dans la Library de l’application XBOX, sous le filtre Access.
msxbox://playtest/. La CLI ne peut pas encore
afficher ce lien. Il fonctionne uniquement pour les personnes du public 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 téléverser des packages à partir de pipelines d’intégration continue (CI) avec un principal de service. Consultez Téléverser des 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, ces commandes ne peuvent pas vous demander de confirmation et n’apportent 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.