xbox xbl achievement-image carga imágenes PNG para los logros de un título y lee las
imágenes registradas para él. --scid acepta el identificador de configuración de servicio (SCID) del título.
upload devuelve un iconImageId que debes incluir en la configuración de logros del título.
Opciones
Ejemplos
Carga una imagen:assetId que devuelve upload para comprobar la imagen y para descargarla junto con su
miniatura en achievement-images/<assetId>/:
Salida
upload y get devuelven un objeto de imagen, y list devuelve una matriz de ellos, o [].
Cada objeto tiene los campos del servicio, como assetId, cdnUrl, thumbnailCdnUrl,
widthInPixels y heightInPixels, además de iconImageId, que es igual a assetId:
iconImageId en la configuración achievements2017.xml del título:
ASSET ID, CDN FILENAME, WIDTH, HEIGHT, IMAGE TYPE y PUBLIC.
Usa JSON para obtener las direcciones URL completas de la CDN y otros campos.
download devuelve un manifiesto: un objeto con assetId, destination, imagePath,
thumbnailPath, imageBytes y thumbnailBytes para --asset-id, o una matriz de ellos para
--all. Su tabla muestra ASSET ID y DESTINATION. Los archivos con el mismo nombre se reemplazan,
y los demás archivos de la carpeta del recurso se conservan. Si una descarga produce un error, los archivos existentes de ese recurso
se quedan como estaban; con --all, las carpetas ya descargadas se conservan.
Un comando que produce un error sale con 1 y escribe el error en stderr. Cuando el servicio rechaza la imagen,
el error enumera cada mensaje de validación.
Seguridad en producción y recuperación de cargas
Cada carga registra una imagen nueva, incluso del mismo archivo, y la CLI nunca reintenta una. Siupload informa de Upload outcome unknown, es posible que la imagen se haya registrado: ejecuta el comando get
o list que imprime en stderr antes de volver a cargarla, y usa el identificador de recurso existente si
encuentras tu imagen. Si pulsas Ctrl+C antes de que se envíe el registro, no se registra nada.
Para inspeccionar la imagen completa y la miniatura, descárgalas:
upload no pregunta antes de registrar una imagen, y --confirm no se aplica a este comando. Consulta
Seguridad y operaciones destructivas.