> ## 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

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

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](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-CA/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 **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](https://docs.xbox.com/fr-CA/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-CA/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. 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` :

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

La [référence de 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'état :

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

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

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

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

## 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`](https://docs.xbox.com/fr-CA/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` 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` :

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

Si `xbox audience list` expire, un [problème connu](https://docs.xbox.com/fr-CA/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 à 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 :

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

```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,
et se termine avec le code `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 aucun package, aucun public ou aucune classification par âge. Rien n'est publié. Corrigez les éléments 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 | Le test de jeu est toujours en cours de publication après 5 minutes. Vérifiez-le plus tard avec `xbox playtest get`. |

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

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

## 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](https://docs.xbox.com/fr-CA/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-CA/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, 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`.


## Related topics

- [Utiliser Playtest](https://docs.xbox.com/fr-CA/publishing/game-publishing/concepts/playtest-preview.md)
- [Prise en main](https://docs.xbox.com/fr-CA/tools/xbox-cli/getting-started.md)
- [Simulation de la latence lors des tests de votre jeu](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/game-streaming-simulate-latency-while-testing.md)
- [Diffusion de votre jeu en continu](https://docs.xbox.com/fr-CA/build/core-features/common/game-streaming/game-streaming-stream-your-game.md)
- [Tests de durabilité des jeux avec votre kit de développement](https://docs.xbox.com/fr-CA/build/game-principles/sustainability/sustainability-devkit-guide.md)
