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 :assetId retourné par upload pour vérifier l’image, puis pour la télécharger avec sa
miniature dans achievement-images/<assetId>/ :
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 :
iconImageId dans la configuration achievements2017.xml du titre :
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. Siupload 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.