Passer au contenu principal
Un test de jeu permet à un groupe choisi de joueurs d’essayer un jeu avant sa sortie. Les commandes playtest lisent les tests de jeu d’un jeu dans Partner Center, et les créent, les mettent à jour, les publient et les suppriment. create, update, publish et delete demandent une confirmation avant d’apporter une modification. create, update, publish et delete sont expérimentales : leurs options et leur sortie pourraient changer ou être retirées. Consultez Commandes expérimentales.

Commandes

Arguments et options

Exemples

Répertorier les tests de jeu, en obtenir un et en comparer deux :
Créer un test de jeu pour un public :
Modifier la date de fin d’un test de jeu :
Publier un test de jeu :
Supprimer un test de jeu :

Lire les tests de jeu

playtest list écrit un tableau playtests. Son tableau de sortie comporte les colonnes PLAYTEST ID, NAME, STATUS, TYPE, START et END. Un extrait :
playtest get écrit le test de jeu tel que le service le retourne. etag est la version à transmettre à update --if-match, et audiences.audienceIds répertorie les publics qui peuvent participer. Son tableau de sortie comporte des lignes FIELD et VALUE. playtest diff écrit hasDiffData, current et compared. Lorsque hasDiffData est false, il n’y a rien à comparer, et compared est omis. Son tableau de sortie affiche seulement les champs qui diffèrent, dans les colonnes FIELD, CURRENT et COMPARED. Les images ne sont pas comparées.

Créer un test de jeu

playtest create crée un test de jeu privé à l’état de brouillon et l’écrit comme le fait playtest get. L’exécuter de nouveau crée un autre test de jeu; supprimez celui dont vous ne voulez pas avec playtest delete. Chaque création envoie une clé d’idempotence, un nouveau GUID à moins que vous ne transmettiez --idempotency-key. Une création qui répète une clé retourne le test de jeu que cette clé a créé, et ignore toutes les options qui diffèrent. Lorsque le résultat est inconnu, par exemple après un délai d’expiration, la commande se termine avec le code 3 et affiche une commande qui fait une nouvelle tentative avec la même clé :
La nouvelle tentative retourne le test de jeu si la première requête l’a créé, et le crée dans le cas contraire. Lorsqu’une option contient un saut de ligne, seule la clé est affichée; exécutez la même commande avec --idempotency-key et cette clé. Si la nouvelle tentative est refusée, par exemple parce que la date de fin est passée, vérifiez playtest list avant de créer le test de jeu avec une nouvelle clé.

Packages

Un test de jeu peut avoir un package PC et un package pour console. Choisissez un package prêt pour un test de jeu dans xbox package list, et transmettez son id à l’option de sa plateforme :
Avec update, une option de package que vous omettez conserve son package, un nouvel ID le remplace, et "" le retire :

Mettre à jour un test de jeu

Toute mise à jour remet un test de jeu publié à l’état de brouillon, comme le fait sa modification dans Partner Center. Publiez-le de nouveau avec playtest publish pour le rendre accessible aux joueurs.
playtest update modifie seulement les options que vous transmettez, et en nécessite au moins une. Elle écrit le test de jeu mis à jour comme le fait playtest get. Les illustrations du jeu configurées dans Partner Center sont conservées; les autres illustrations liées au test de jeu sont remplacées par un espace réservé. Pour éviter d’écraser la modification d’une autre personne, transmettez dans --if-match le etag provenant de playtest get. Les guillemets doubles qui l’entourent sont facultatifs, et *, les etags faibles (W/) et les listes d’etags sont refusés :
Lorsque le résultat est inconnu, la commande se termine avec le code 3. Vérifiez le test de jeu avec playtest get avant de faire une nouvelle tentative.

Choisir les publics

Un public est un groupe de joueurs, comme des testeurs, que le vendeur gère dans Partner Center. Transmettez un id provenant de audience list à --audience-id, et répétez l’option pour en ajouter d’autres :
Sans --audience-id, create crée un test de jeu sans public, et update conserve les publics existants. Avec update, les ID que vous transmettez remplacent tous les publics du test de jeu. Pour retirer tous les publics, transmettez "" seul :
"" ne peut pas être combiné avec des ID de public, et create le refuse. Un test de jeu doit avoir au moins un public pour être publié.

Publier un test de jeu

Si le jeu utilise les XBOX services, configurez leur configuration et leur embargo avant de publier. Consultez Utiliser les XBOX services dans un test de jeu.
La publication offre le test de jeu à ses publics à partir de sa date de début. La commande publie la version qu’elle lit en premier; si le test de jeu change entre-temps, la publication échoue avec 412 et ne modifie rien. Avant de vous demander de confirmer, la commande vérifie la configuration des XBOX services du jeu, par exemple si sa date d’embargo est postérieure à la date de fin du test de jeu, et répertorie dans stderr tout élément à examiner. Ces vérifications sont seulement indicatives; --confirm publie sans demander de confirmation. Le service exécute ensuite ses propres vérifications. Lorsque l’une d’elles bloque la publication, rien n’est mis en file d’attente, et la commande répertorie chaque vérification dans stderr et se termine avec le code 1. Corrigez les erreurs et publiez de nouveau. Pour un test de jeu bloqué en raison de classifications par âge manquantes, il faut remplir le questionnaire de classification par âge dans Partner Center. Une fois la publication mise en file d’attente, la commande attend que le test de jeu soit Scheduled, Live ou PublishFailed, et l’écrit comme le fait playtest get. Ctrl+C arrête l’attente, mais la publication se poursuit. Avec --no-wait, la commande écrit publishJobId et tout warnings dès que la publication est mise en file d’attente; suivez-la ensuite avec playtest get.

Supprimer un test de jeu

playtest delete supprime la version du test de jeu qu’elle lit en premier. Elle attend que le test de jeu soit Deleted ou n’existe plus, puis écrit la réponse du service, avec status. Ctrl+C arrête l’attente, mais la suppression se poursuit. Avec --no-wait, elle écrit la réponse dès que la suppression est mise en file d’attente. Après une erreur 412, la suppression est peut-être déjà en file d’attente; attendez donc une minute et vérifiez avec playtest get avant de supprimer de nouveau.

Dates

--start et --end acceptent des dates et heures ISO 8601, comme 2026-11-01T09:00:00-07:00 ou 2026-11-01T16:00:00Z. Une date sans heure correspond à minuit UTC, et une heure sans décalage est en UTC. Lorsqu’une mise à jour ne transmet qu’une seule date, le service la vérifie par rapport à l’autre date du test de jeu.

Erreurs

Les échecs sont écrits dans stderr et se terminent avec le code 1, sauf indication contraire dans les tableaux de codes de sortie ci-dessus. create et update se terminent avec le code 3 lorsque leur résultat est inconnu. Un échec retourné par le service inclut son état HTTP, et --verbose ajoute la réponse du service, dont le champ code est indiqué ici : Pour les autres échecs, la commande affiche le message du service. Une erreur 429 signifie que vous avez envoyé trop de requêtes; attendez la durée indiquée dans le message avant de réessayer.
Dernière modification le 19 novembre 2026