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

Options

Exemples

Téléverser une image :
Transmettez le assetId retourné 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, puis les télécharger toutes :

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 :
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 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 :
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.
Dernière modification le 19 novembre 2026