Passer au contenu principal
Un test de jeu permet à un groupe choisi de joueurs 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 du téléversement 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 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 package et playtest échouent avec l’erreur 403 package_permission_denied. Demandez-la à un gestionnaire 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. Téléverser un package

La CLI ne téléverse pas les packages. Téléversez 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 de 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’état :
Le package est prêt lorsque 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 :
Si 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 dans testers.txt, une par ligne, et créer le public avec la commande expérimentale audience create :
Notez l’id du public pour pouvoir l’ajouter au test de jeu.

3. Créer le test de jeu

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