Pular para o conteúdo principal
xbox xbl achievement-image carrega imagens PNG para as conquistas de um título e lê de volta as imagens registradas para ele. --scid recebe o identificador de configuração de serviço (SCID) do título. upload retorna uma iconImageId para colocar na configuração de conquistas do título.

Opções

Exemplos

Carregue uma imagem:
Passe o assetId que upload retorna para verificar a imagem e para baixá-la, junto com sua miniatura, em achievement-images/<assetId>/:
Liste todas as imagens registradas para o SCID e baixe todas elas:

Saída

upload e get retornam um objeto de imagem, e list retorna uma matriz desses objetos, ou []. Cada objeto tem os campos do serviço, como assetId, cdnUrl, thumbnailCdnUrl, widthInPixels e heightInPixels, além de iconImageId, que é igual a assetId:
Copie iconImageId para a configuração achievements2017.xml do título:
As tabelas desses comandos mostram ASSET ID, CDN FILENAME, WIDTH, HEIGHT, IMAGE TYPE e PUBLIC. Use JSON para obter as URLs completas da CDN e os outros campos. download retorna um manifesto: um objeto com assetId, destination, imagePath, thumbnailPath, imageBytes e thumbnailBytes para --asset-id, ou uma matriz desses objetos para --all. Sua tabela mostra ASSET ID e DESTINATION. Arquivos com os mesmos nomes são substituídos, e os outros arquivos da pasta do ativo são mantidos. Se um download falhar, os arquivos existentes desse ativo permanecem como estavam; com --all, as pastas já baixadas permanecem. Um comando com falha sai com o código 1 e grava o erro em stderr. Quando o serviço rejeita a imagem, o erro lista cada mensagem de validação.

Segurança em produção e recuperação de carregamentos

Cada carregamento registra uma nova imagem, mesmo que seja do mesmo arquivo, e a CLI nunca repete um carregamento. Se upload relatar Upload outcome unknown, a imagem pode ter sido registrada: execute o comando get ou list que ele imprime em stderr antes de carregar novamente e use a ID do ativo existente se encontrar sua imagem. Pressionar Ctrl+C antes de o registro ser enviado não registra nada. Para inspecionar a imagem completa e a miniatura, baixe-as:
upload não pede confirmação antes de registrar uma imagem, e --confirm não se aplica a ele. Consulte Segurança e operações destrutivas.
Última modificação em 19 de novembro de 2026