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

# Images de succès

> Téléversez, obtenez, répertoriez et téléchargez des images de succès XBOX.

`xbox xbl achievement-image` téléverse des images PNG pour les succès d'un titre et relit les
images inscrites pour celui-ci. `--scid` accepte l'identificateur de configuration de service (SCID) du titre.
`upload` retourne un `iconImageId` à placer dans la configuration des succès du titre.

| Commande | Effet |
| - | - |
| `achievement-image upload` | Téléverse une nouvelle image et l'inscrit pour le SCID. |
| `achievement-image get` | Recherche une image inscrite. |
| `achievement-image list` | Répertorie les images inscrites pour un SCID. |
| `achievement-image download` | Enregistre les images complètes et les miniatures sous `--dest`. |

## Options

| Option | Commande | Obligatoire | Description |
| - | - | - | - |
| `--scid <guid>` | toutes | Oui | SCID du titre XBOX. |
| `--seller-id <id>` | toutes | Non | ID de vendeur Partner Center. Valeur par défaut déterminée comme le décrit [Contexte](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/context.md), puis votre seul vendeur. |
| `--file <path>` | `upload` | Oui | Fichier `.png` local, d'exactement **1920 × 1080 pixels** et d'au plus **20 Mio**. |
| `--asset-id <guid>` | `get`, `download` | Pour `get`; `--asset-id` ou `--all` pour `download` | ID de ressource retourné par `upload` ou trouvé avec `list`. |
| `--all` | `download` | Solution de rechange à `--asset-id` | Télécharge toutes les images inscrites pour le SCID. |
| `--dest <directory>` | `download` | Oui | Enregistre chaque image et sa miniature dans un sous-dossier nommé d'après son ID de ressource. |
| `--output <format>` | toutes | Non | `json` (par défaut), `json-compact` ou `table`. |

## Exemples

Téléverser une image :

```bash theme={null}
xbox xbl achievement-image upload \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --file achievement-1920x1080.png
```

Transmettez le `assetId` retourné par `upload` pour vérifier l'image, puis pour la télécharger avec sa
miniature dans `achievement-images/<assetId>/` :

```bash theme={null}
xbox xbl achievement-image get \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --output json-compact

xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --dest achievement-images
```

Répertorier toutes les images inscrites pour le SCID, puis les télécharger toutes :

```bash theme={null}
xbox xbl achievement-image list \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --output table

xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --all --dest achievement-images --output table
```

## Sortie

`upload` et `get` retournent un objet image, et `list` en retourne un tableau, ou `[]`.
Chaque objet contient les champs du service, comme `assetId`, `cdnUrl`, `thumbnailCdnUrl`,
`widthInPixels` et `heightInPixels`, ainsi que `iconImageId`, qui est égal à `assetId` :

```json theme={null}
{
  "assetId": "11111111-2222-3333-4444-555555555555",
  "iconImageId": "11111111-2222-3333-4444-555555555555"
}
```

Copiez `iconImageId` dans la configuration `achievements2017.xml` du titre :

```xml theme={null}
<IconImageId>11111111-2222-3333-4444-555555555555</IconImageId>
```

Leurs tableaux affichent `ASSET ID`, `CDN FILENAME`, `WIDTH`, `HEIGHT`, `IMAGE TYPE` et `PUBLIC`.
Utilisez JSON pour obtenir les URL CDN complètes et les autres champs.

`download` retourne un manifeste : un objet avec `assetId`, `destination`, `imagePath`,
`thumbnailPath`, `imageBytes` et `thumbnailBytes` pour `--asset-id`, ou un tableau de tels objets pour
`--all`. Son tableau affiche `ASSET ID` et `DESTINATION`. Les fichiers portant les mêmes noms sont remplacés,
et les autres fichiers du dossier de la ressource sont conservés. Si un téléchargement échoue, les fichiers existants de cette ressource
restent tels quels; avec `--all`, les dossiers déjà téléchargés sont conservés.

Une commande qui échoue se termine avec le code 1 et écrit l'erreur dans stderr. Lorsque le service rejette l'image,
l'erreur répertorie chaque message de validation.

## Sécurité en production et récupération après un téléversement

Chaque téléversement inscrit une nouvelle image, même pour le même fichier, et la CLI ne relance jamais un téléversement. Si
`upload` signale `Upload outcome unknown`, l'image a peut-être été inscrite : exécutez la commande `get`
ou `list` qu'il affiche dans stderr avant de téléverser de nouveau, et utilisez l'ID de ressource existant si
vous trouvez votre image. Un Ctrl+C effectué avant l'envoi de l'inscription n'inscrit rien.

Pour inspecter l'image complète et la miniature, téléchargez-les :

```bash theme={null}
xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --dest achievement-images
```

`upload` ne demande pas de confirmation avant d'inscrire une image, et `--confirm` ne s'y applique pas. Consultez
[Sécurité et opérations destructives](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md).


## Related topics

- [Configuration des XBOX services](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/xbl.md)
- [Succès basés sur les événements et succès gérés par le titre](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/achievements/live-achievements-eb-vs-tm.md)
- [Systèmes de succès utilisateur](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/achievements/live-achievements-nav.md)
- [Scénarios de création de succès basés sur les événements](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/achievements/event-based/concepts/live-achievements-scenarios.md)
- [Retirer l'étiquette de l'image de conteneur](https://docs.xbox.com/fr-CA/services/playfab/api-references/rest/multiplayer/multiplayer-server/untag-container-image.md)
