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 peuvent changer
ou être supprimées. Consultez Commandes expérimentales.
Commandes
Arguments et options
Exemples
Répertorier les tests de jeu, en obtenir un et en comparer deux :Lecture des 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 renvoie. etag est la version à passer à
update --if-match, et audiences.audienceIds répertorie les audiences autorisées à participer. Son tableau de sortie comporte
des lignes FIELD et VALUE.
playtest diff écrit hasDiffData, current et compared. Lorsque hasDiffData vaut false,
il n’y a rien à comparer et compared est omis. Son tableau de sortie affiche uniquement les champs qui
diffèrent, dans les colonnes FIELD, CURRENT et COMPARED. Les images ne sont pas comparées.
Création d’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 sauf si vous passez --idempotency-key. Une création qui
réutilise une clé renvoie le test de jeu créé avec cette clé et ignore toute option différente.
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 relance l’opération avec la même clé :
--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 console. Choisissez un package prêt pour un test de jeu dansxbox package list, et passez son id à l’option
de sa plateforme :
update, une option de package omise conserve son package, un nouvel ID le remplace, et ""
le supprime :
Mise à jour d’un test de jeu
playtest update modifie uniquement les options que vous passez, 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 de quelqu’un d’autre, passez l’etag provenant de playtest get dans --if-match.
Les guillemets doubles qui l’entourent sont facultatifs, et *, les etags faibles (W/) et les listes d’etags sont
refusés :
3. Vérifiez le test de jeu avec playtest get avant
de réessayer.
Choix des audiences
Une audience est un groupe de joueurs, comme des testeurs, que le vendeur gère dans Partner Center. Passez unid provenant de audience list à --audience-id, et répétez l’option pour en ajouter d’autres :
--audience-id, create crée un test de jeu sans audience, et update conserve les audiences existantes. Avec
update, les ID que vous passez remplacent toutes les audiences du test de jeu. Pour supprimer toutes les audiences, passez
"" seul :
"" ne peut pas être combiné avec des ID d’audience, et create le refuse. Un test de jeu doit avoir au moins une
audience pour être publié.
Publication d’un test de jeu
Si le jeu utilise les XBOX services, configurez-les ainsi que leur embargo avant de publier. Consultez Utiliser les XBOX services dans un test de jeu.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 sur stderr tout ce qui doit être examiné. Ces
vérifications sont uniquement 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 sur stderr et se termine avec le code 1. Corrigez les erreurs et publiez de nouveau. Un test de jeu
bloqué en raison de classifications par âge manquantes nécessite que le questionnaire de classification par âge soit rempli 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, puis l’écrit comme le fait playtest get. Ctrl+C interrompt l’attente, mais la publication
se poursuit. Avec --no-wait, la commande écrit publishJobId et les éventuels warnings dès que la
publication est mise en file d’attente ; suivez-la avec playtest get.
Suppression d’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 interrompt 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 un 412, la suppression est peut-être déjà en file d’attente ; patientez 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 exprimée
en UTC. Lorsqu’une mise à jour ne passe qu’une seule date, le service la vérifie par rapport à l’autre date du test de jeu.
Erreurs
Les échecs sont écrits sur stderr et se terminent avec le code1, 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 renvoyé 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. Un 429 signifie que vous avez envoyé trop de
requêtes ; attendez le temps indiqué dans le message avant de réessayer.
