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