> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Votre premier test de jeu

> Chargez un build d'un jeu XBOX, puis créez, publiez et partagez un test de jeu de ce build avec la XBOX CLI et Partner Center.

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](https://learn.microsoft.com/gaming/game-publishing/concepts/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](https://docs.xbox.com/fr/tools/xbox-cli/cli-command-lifecycle.md).

## 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](https://docs.xbox.com/fr/tools/xbox-cli/getting-started.md).

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](https://docs.xbox.com/fr/tools/xbox-cli/xbox-services-in-a-playtest.md).

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` :

```text theme={null}
makepkg upload /d layout /msixvc2 /pc /storeid 9N0000000000 /branch Main
```

La [référence makepkg](https://learn.microsoft.com/gaming/gdk/docs/features/common/packaging/deployment/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 :

```bash theme={null}
xbox package list --store-id 9N0000000000 --output table
```

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` :

```bash theme={null}
xbox package list --store-id 9N0000000000
```

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](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#prerequisites-for-a-playtest).

## 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`](https://docs.xbox.com/fr/tools/xbox-cli/commands/audience#creating-an-audience) :

```bash theme={null}
xbox audience create --name "Nod Arena testers" --members-file testers.txt
```

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` :

```bash theme={null}
xbox audience list --output table
```

Si `xbox audience list` expire, ce qui est un [problème connu](https://docs.xbox.com/fr/tools/xbox-cli/known-issues.md#xbox-audience-list-can-time-out),
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 :

```bash theme={null}
xbox playtest create --store-id 9N0000000000 --name "Nod Arena playtest" --start 2026-12-01 --end 2026-12-15 --pc-package-id 11111111-2222-3333-4444-555555555555 --audience-id 1152921504606846976
```

* `--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 :

```bash theme={null}
xbox playtest publish 11111111-2222-3333-4444-555555555555 --store-id 9N0000000000
```

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é :

| Code de sortie | Signification |
| - | - |
| 1 | Les vérifications de Partner Center ont échoué, par exemple parce que le test de jeu n'a pas de package, d'audience ou de classifications par âge. Rien n'est publié. Corrigez les points que la commande répertorie, puis publiez de nouveau. |
| 2 | La publication a échoué. |
| 3 | Le résultat est inconnu. Vérifiez le test de jeu avec `xbox playtest get` avant de publier de nouveau. |
| 4 | La publication du test de jeu est toujours en cours après 5 minutes. Vérifiez-la plus tard avec `xbox playtest get`. |

Consultez [Publication d'un test de jeu](https://docs.xbox.com/fr/tools/xbox-cli/commands/playtest.md#publishing-a-playtest).

## 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](https://learn.microsoft.com/gaming/game-publishing/concepts/playtest-preview#share-a-playtest-with-testers).

## 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](https://docs.xbox.com/fr/tools/xbox-cli/commands/package.md#uploading-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)](https://docs.xbox.com/fr/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

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`.


## Related topics

- [Utiliser Playtest](https://docs.xbox.com/fr/publishing/game-publishing/concepts/playtest-preview.md)
- [XBOX CLI](https://docs.xbox.com/fr/tools/xbox-cli/index.md)
- [Prise en main](https://docs.xbox.com/fr/tools/xbox-cli/getting-started.md)
- [Streaming de votre jeu](https://docs.xbox.com/fr/build/core-features/common/game-streaming/game-streaming-stream-your-game.md)
- [Simulation de la latence lors du test de votre jeu](https://docs.xbox.com/fr/build/core-features/common/game-streaming/game-streaming-simulate-latency-while-testing.md)
