Saltar al contenido principal
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:
Pasa el assetId que devuelve upload para comprobar la imagen y para descargarla junto con su miniatura en achievement-images/<assetId>/:
Enumera todas las imágenes registradas para el SCID y descárgalas todas:

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:
Copia iconImageId en la configuración achievements2017.xml del título:
Sus tablas muestran 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. Si upload 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.
Última modificación el 19 de noviembre de 2026