> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Imágenes de logros

> Carga, obtén, enumera y descarga imágenes de logros de XBOX.

`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.

| Comando | Efecto |
| - | - |
| `achievement-image upload` | Carga una imagen nueva y la registra para el SCID. |
| `achievement-image get` | Busca una imagen registrada. |
| `achievement-image list` | Enumera las imágenes registradas para un SCID. |
| `achievement-image download` | Guarda las imágenes completas y las miniaturas en `--dest`. |

## Opciones

| Opción | Comando | Obligatoria | Descripción |
| - | - | - | - |
| `--scid <guid>` | todos | Sí | SCID del título de XBOX. |
| `--seller-id <id>` | todos | No | Identificador de vendedor de Partner Center. El valor predeterminado es el que describe [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md) y, después, tu único vendedor. |
| `--file <path>` | `upload` | Sí | Archivo `.png` local, de exactamente **1920 × 1080 píxeles** y como máximo **20 MiB**. |
| `--asset-id <guid>` | `get`, `download` | Para `get`; para `download`, `--asset-id` o `--all` | Identificador de recurso devuelto por `upload` o encontrado con `list`. |
| `--all` | `download` | Alternativa a `--asset-id` | Descarga todas las imágenes registradas para el SCID. |
| `--dest <directory>` | `download` | Sí | Guarda cada imagen y su miniatura en una subcarpeta con el nombre de su identificador de recurso. |
| `--output <format>` | todos | No | `json` (predeterminado), `json-compact` o `table`. |

## Ejemplos

Carga una imagen:

```bash theme={null}
xbox xbl achievement-image upload \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --file achievement-1920x1080.png
```

Pasa el `assetId` que devuelve `upload` para comprobar la imagen y para descargarla junto con su
miniatura en `achievement-images/<assetId>/`:

```bash theme={null}
xbox xbl achievement-image get \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --output json-compact

xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --dest achievement-images
```

Enumera todas las imágenes registradas para el SCID y descárgalas todas:

```bash theme={null}
xbox xbl achievement-image list \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --output table

xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --all --dest achievement-images --output table
```

## 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`:

```json theme={null}
{
  "assetId": "11111111-2222-3333-4444-555555555555",
  "iconImageId": "11111111-2222-3333-4444-555555555555"
}
```

Copia `iconImageId` en la configuración `achievements2017.xml` del título:

```xml theme={null}
<IconImageId>11111111-2222-3333-4444-555555555555</IconImageId>
```

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:

```bash theme={null}
xbox xbl achievement-image download \
  --scid aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee --seller-id 1234567 \
  --asset-id 11111111-2222-3333-4444-555555555555 --dest achievement-images
```

`upload` no pregunta antes de registrar una imagen, y `--confirm` no se aplica a este comando. Consulta
[Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).


## Related topics

- [Configuración de servicios XBOX](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl.md)
- [Configuración de recompensas de logros de XBOX](https://docs.xbox.com/es/services/xbox-services/player-data/achievements/title-managed/concepts/live-achievement-rewards.md)
- [XR-057 Desbloqueo de logros](https://docs.xbox.com/es/publishing/certification/xr/xr-057.md)
- [Configuración de logros administrados por el título en Partner Center](https://docs.xbox.com/es/services/xbox-services/player-data/achievements/title-managed/config/live-achievements-tm-config.md)
- [Requisitos de XBOX probados en la certificación para juegos de XBOX](https://docs.xbox.com/es/publishing/certification/console-cert-tested-requirements.md)
