Passer au contenu principal
Un test de jeu permet à un groupe de joueurs choisis d’installer un build de votre jeu sur des consoles XBOX et des PC, avant ou après la sortie, sans certification ni fiche dans le Microsoft Store. Cette page vous guide depuis le chargement d’un build jusqu’au partage du test de jeu avec les testeurs. Vue d’ensemble de Playtest explique le fonctionnement des tests de jeu. La plupart des commandes de cette page sont expérimentales : leurs options et leur sortie peuvent donc changer. Consultez Commandes expérimentales.

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 package et playtest échouent avec l’erreur 403 package_permission_denied. Demandez-la à un responsable de votre compte Partner Center, ou passez --seller-id si le jeu appartient à un autre vendeur.
  • Connectez-vous avec xbox auth login et choisissez un vendeur, comme dans Prise en main.
Un test de jeu s’exécute dans le sandbox RETAIL. Si le build utilise la connexion XBOX ou d’autres XBOX services, suivez d’abord Utiliser les XBOX services dans un test de jeu. Les exemples utilisent le Store ID 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 avec makepkg à 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 :
La référence makepkg couvre les autres formats de package. Partner Center traite ensuite le package, ce qui peut prendre un certain temps. Pour en vérifier l’avancement :
Le package est prêt lorsque 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 :
Si 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 dans testers.txt, une par ligne, et créer l’audience avec la commande expérimentale audience create :
Notez l’id de l’audience pour l’ajouter au test de jeu.

3. Créer le test de jeu

Si vous avez créé l’audience avec audience create, utilisez l’id affiché. Si vous avez créé le groupe dans Partner Center, trouvez son ID :
Si 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-id prend l’ID de package de l’étape 1. Utilisez --console-package-id pour un package console.
  • --audience-id prend l’ID de l’audience. Répétez cette option pour ajouter d’autres audiences.
  • Les testeurs peuvent installer le test de jeu de --start jusqu’à --end. Une date sans heure correspond à minuit UTC.
La commande demande confirmation avant de créer le test de jeu, puis l’affiche au format JSON. Notez l’ID du test de jeu, qui correspond à 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 :
La commande attend que le test de jeu soit 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.
Les testeurs nouvellement ajoutés doivent d’abord se déconnecter puis se reconnecter. Vous pouvez également envoyer un lien aux testeurs. Sur la page Playtest du jeu dans Partner Center, sélectionnez Partager sur le test de jeu, puis copiez le lien, qui commence par 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 commandes xbox 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.
Dernière modification le 19 novembre 2026