Passer au contenu principal
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.

Options

Exemples

Charger une image :
Passez le assetId renvoyé par upload pour vérifier l’image, puis pour la télécharger avec sa miniature dans achievement-images/<assetId>/ :
Répertorier toutes les images inscrites pour le SCID et les télécharger toutes :

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 :
Copiez iconImageId dans la configuration achievements2017.xml du titre :
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 :
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.
Dernière modification le 19 novembre 2026