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

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

`xbox xbl achievement-image` charge 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` renvoie un `iconImageId` à placer dans la configuration des succès du titre.

| Commande | Effet |
| - | - |
| `achievement-image upload` | Charge 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 décrit dans [Contexte](https://docs.xbox.com/fr/tools/xbox-cli/commands/context.md), puis votre seul vendeur. |
| `--file <path>` | `upload` | Oui | Fichier `.png` local, de **1920 × 1080 pixels** exactement et d'au plus **20 Mio**. |
| `--asset-id <guid>` | `get`, `download` | Pour `get` ; `--asset-id` ou `--all` pour `download` | ID de ressource renvoyé par `upload` ou trouvé avec `list`. |
| `--all` | `download` | Alternative à `--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 portant le nom de son ID de ressource. |
| `--output <format>` | toutes | Non | `json` (par défaut), `json-compact` ou `table`. |

## Exemples

Charger une image :

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

Passez le `assetId` renvoyé 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 et 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` renvoient un objet image, et `list` renvoie un tableau de ces objets, 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` renvoie un manifeste : un objet contenant `assetId`, `destination`, `imagePath`,
`thumbnailPath`, `imageBytes` et `thumbnailBytes` pour `--asset-id`, ou un tableau de ces objets pour
`--all`. Son tableau affiche `ASSET ID` et `DESTINATION`. Les fichiers portant le même nom 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 sur 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 chargement

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

Pour examiner 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 destructrices](https://docs.xbox.com/fr/tools/xbox-cli/safety.md).


## Related topics

- [Configuration des XBOX services](https://docs.xbox.com/fr/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/services/xbox-services/player-data/achievements/live-achievements-eb-vs-tm.md)
- [Systèmes de succès utilisateur](https://docs.xbox.com/fr/services/xbox-services/player-data/achievements/live-achievements-nav.md)
- [URI des images de joueur](https://docs.xbox.com/fr/reference/live/rest/uri/gamerpic/atoc-reference-gamerpic.md)
- [Mise à jour de succès (JSON)](https://docs.xbox.com/fr/reference/live/rest/json/json-achievementupdaterequest.md)
