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

# Jeux

> Répertoriez les jeux Partner Center d'un vendeur, recherchez-en un, créez un jeu et vérifiez son travail de création.

Les commandes `game` répertorient les jeux Partner Center d'un vendeur, en recherchent un par ID Store, ID de titre XBOX
ou nom, créent un jeu et vérifient son travail de création.

Chaque commande agit sur un seul vendeur, provenant de `--seller-id` ou de votre vendeur enregistré; consultez
[Contexte](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/context.md). Si vous appartenez à plusieurs vendeurs, consultez
[ce problème connu](https://docs.xbox.com/fr-CA/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id) : ces commandes peuvent
utiliser un autre vendeur.

## Commandes

| Commande | Description |
| - | - |
| `game list` | Répertorie tous les jeux du vendeur. |
| `game get` | Obtient des jeux par ID Store, ID de titre XBOX ou mot clé du nom. |
| `game create` | Crée un jeu, puis attend son travail de création. |
| `game job get` | Lit l'état actuel d'un travail de création de jeu. |

## Arguments

| Argument | Commande | Description |
| - | - | - |
| `[title-id]` | `get` | Un ID de titre XBOX : de un à huit chiffres hexadécimaux, avec un préfixe `0x` facultatif, comme `1234ABCD`. `42` signifie `0x00000042`. |
| `<job-id>` | `job get` | L'ID du travail de création qu'affiche `game create`. |

## Options

| Option | Commandes | Description |
| - | - | - |
| `--seller-id <id>` | toutes | ID de vendeur Partner Center. |
| `--base-url <url>` | toutes | URL de base des requêtes, qui remplace la clé de configuration `XboxPartner:BaseUrl`. |
| `--store-id <id>` | `get` | ID Microsoft Store du jeu, comme `9N0000000000`. Peut être combinée avec `title-id` pour affiner le résultat. |
| `--keyword <text>` | `get` | Trouve les jeux dont le nom contient ce texte, sans tenir compte de la casse. Ne peut pas être combinée avec `title-id` ou `--store-id`. |
| `-d`, `--details` | `list`, `get` | Affiche un bloc de texte par jeu. Ne peut pas être combinée avec `--output`. |
| `--name <name>` | `create` | Obligatoire. Le nom du jeu. |
| `--supported-device <device>` | `create` | Obligatoire. `xbox` ou `desktop`; répétez l'option pour les deux. |
| `--sandbox-id <id>` | `create` | Le sandbox de développement du jeu. Il doit s'agir d'un sandbox Shared existant; [`sandbox get`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/sandbox) affiche le type d'un sandbox. |
| `--confirm`, `--yes`, `-y` | `create` | Crée le jeu sans l'invite de confirmation. |
| `--output <format>` | toutes | `json` (par défaut) ou `json-compact`; `table` avec `list` et `get` seulement. |

`game get` a besoin d'au moins un des éléments `title-id`, `--store-id` ou `--keyword`. La valeur positionnelle est
toujours un ID de titre XBOX; lorsqu'elle ressemble à un ID Store, l'erreur suggère la même commande avec
`--store-id` :

```text theme={null}
title-id must be one to eight hexadecimal digits, with an optional 0x prefix. 9N0000000000 looks like a Store ID. Did you mean:
  xbox game get --store-id 9N0000000000 --seller-id 1234567
```

## Répertorier et rechercher

```bash theme={null}
xbox game list --output table
xbox game get --store-id 9N0000000000
xbox game get 1234ABCD --details
xbox game get --keyword "nod arena" --output table
```

`game list` retourne l'ensemble du catalogue du vendeur, et `game get` avec `--keyword` effectue une recherche dans tout
celui-ci. La lecture d'un catalogue volumineux peut prendre quelques minutes, et la commande affiche sa
[progression](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands.md#progress) sur stderr. Il n'y a aucune option de pagination; paginez la sortie avec
`less` ou `more`. Si une requête échoue, la commande n'affiche aucun résultat partiel et écrit
l'ID de corrélation sur stderr. Chaque requête expire après deux minutes; pour changer ce délai, définissez
`XboxPartner:TimeoutSeconds` (consultez [Configuration](https://docs.xbox.com/fr-CA/tools/xbox-cli/configuration.md)).

## Sortie

La sortie JSON est un tableau `games`. Chaque jeu comporte ces champs :

| Champ | Description |
| - | - |
| `productId` | L'ID de produit Partner Center. |
| `storeId` | L'ID Microsoft Store. |
| `xboxTitleId` | L'ID de titre XBOX : huit chiffres hexadécimaux en majuscules, sans `0x`, comme `"1234ABCD"`. `null` lorsque le jeu n'a pas d'ID de titre valide. |
| `SCID` | L'identificateur de configuration de service (SCID), comme `"00000000-0000-0000-0000-00001234ABCD"`. La clé est en majuscules. `null` lorsque `xboxTitleId` l'est. |
| `name` | Le nom du jeu. |
| `primaryDevelopmentSandbox` | Le sandbox de développement du jeu, ou `null`. |
| `deviceFamilies` | Les appareils pris en charge, comme `["xbox", "desktop"]`. `null` ou `[]` lorsqu'aucun n'est répertorié. |
| `packageIdentityName`, `packageIdentityPublisher`, `packageFamilyName` | L'identité de package du jeu. |
| `msaAppId` | L'ID d'application du compte Microsoft (MSA). |

`game create` et `game job get` écrivent le travail de création. Son champ `game`, avec les mêmes champs,
apparaît une fois que le jeu existe.

### Sortie sous forme de tableau

`list` et `get` acceptent `--output table`, avec une ligne par ID de titre XBOX et ces colonnes :
`TITLE ID`, `STORE IDS`, `PRODUCT NAME`, `MSA APP ID` et `PACKAGE FAMILY NAME`. Les ID Store
et les autres valeurs d'un titre partagent sa ligne, et les valeurs longues sont tronquées. `create` et `job get`
refusent `--output table`.

### Affichage détaillé

`--details` affiche un bloc par ID de titre, avec chaque jeu sous celui-ci et tous ses identificateurs,
y compris le SCID et le sandbox de développement, sans troncature. Les valeurs manquantes s'affichent sous la forme `-`. Avec
`--details` ou `--output table`, le nombre de résultats et la durée sont écrits sur stderr.

## Créer un jeu

```bash theme={null}
xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --seller-id 1234567 --confirm
```

`game create` demande une confirmation avant de créer le jeu; sans terminal, elle a besoin de `--confirm`. La CLI
ne peut pas supprimer un jeu. Si vous appartenez à plusieurs vendeurs, consultez d'abord
[le problème connu](https://docs.xbox.com/fr-CA/tools/xbox-cli/known-issues.md#xbox-game-commands-ignore---seller-id) : le jeu pourrait être
créé dans un autre vendeur.

La commande envoie la requête une seule fois, attend jusqu'à deux minutes le travail de création, puis écrit le
travail sur stdout. L'ID du travail, l'ID de corrélation et les commandes permettant de vérifier le travail sont écrits sur stderr. Si
l'attente se termine en premier, le travail continue de s'exécuter : vérifiez-le avec `game job get`, et ne créez pas le jeu
de nouveau.

Si la requête échoue, stderr indique si un jeu pourrait avoir été créé :

* **Aucun jeu n'a été créé** lorsque la requête n'a pas été envoyée, ou que le service l'a refusée, par exemple avec une erreur
  `400` pour un sandbox que le jeu ne peut pas utiliser. Corrigez le problème et exécutez la commande de nouveau.
* **Le résultat est inconnu** après une erreur de serveur, un délai d'attente expiré ou une connexion perdue. Vérifiez
  `game list` avec la commande affichée sur stderr avant de réessayer.

## Vérifier un travail de création

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

`job get` effectue seulement une lecture; vous pouvez donc l'exécuter aussi souvent que vous le voulez. Un travail qui a réussi peut tout de même
signaler des problèmes dans son champ `errors`.

## Codes de sortie

| Code de sortie | Signification |
| - | - |
| `0` | Le travail a réussi ou est toujours en cours d'exécution. `create` se termine aussi avec le code `0` lorsque son attente prend fin; `0` ne garantit donc pas que le jeu existe. |
| `1` | La commande a échoué. Pour `create`, stderr indique si un jeu pourrait avoir été créé. |
| `2` | Le travail s'est terminé sans créer le jeu. Consultez son champ `errors`. |
| `130` | Vous avez appuyé sur Ctrl+C pendant que la commande lisait, ou pendant que `create` attendait une réponse à sa requête. Pour `create`, stderr indique que le résultat est inconnu. |

Ne vous fiez pas au code de sortie de `create` pour décider de l'exécuter de nouveau. Si stderr indique qu'aucun jeu n'a été
créé, corrigez l'erreur et exécutez-la de nouveau; sinon, vérifiez avec la commande `game job get` ou `game list`
qu'elle a affichée.

## Exemple de bout en bout

Enregistrez un vendeur une fois, puis créez un jeu, qui l'utilise :

```bash theme={null}
xbox context set seller-id 1234567

xbox game create --name "Nod Arena" \
  --supported-device xbox --supported-device desktop \
  --sandbox-id TESTSB.42 --confirm
```

Si l'attente se termine avant le travail, vérifiez le travail au lieu de créer le jeu de nouveau. Utilisez l'ID du
travail que `game create` a affiché sur stderr :

```bash theme={null}
xbox game job get 11111111-2222-3333-4444-555555555555 --output json-compact
```

Une fois le travail réussi, trouvez le jeu :

```bash theme={null}
xbox game get --keyword "Nod Arena" --output table
```


## Related topics

- [Jeux intergénérationnels à double SKU](https://docs.xbox.com/fr-CA/build/console-features/cross-gen/cross-gen-dual-sku.md)
- [Développement de jeux XBOX](https://docs.xbox.com/fr-CA/index.md)
- [Inscription de jeux PC](https://docs.xbox.com/fr-CA/tools/tools-pc/title-registration-pc.md)
- [Pourquoi rendre les jeux accessibles](https://docs.xbox.com/fr-CA/build/game-principles/accessibility/why-make-games-accessible.md)
- [Lanceurs de jeux et appareils portables](https://docs.xbox.com/fr-CA/build/gdk-and-engines/handheld/handheld-launchers.md)
