메인 콘텐츠로 건너뛰기
xbox xbl achievement-image는 타이틀의 도전 과제용 PNG 이미지를 업로드하고, 타이틀에 등록된 이미지를 다시 읽어 옵니다. --scid는 타이틀의 서비스 구성 식별자(SCID)를 받습니다. upload는 타이틀의 도전 과제 구성에 넣을 iconImageId를 반환합니다.

옵션

예제

이미지를 업로드합니다.
upload가 반환한 assetId를 전달하여 이미지를 확인하고, 이미지와 썸네일을 achievement-images/<assetId>/에 다운로드합니다.
SCID에 등록된 모든 이미지를 나열하고 모두 다운로드합니다.

출력

upload와 get은 이미지 개체 하나를 반환하고, list는 이미지 개체의 배열 또는 []를 반환합니다. 각 개체에는 assetId, cdnUrl, thumbnailCdnUrl, widthInPixels, heightInPixels 같은 서비스의 필드와 함께, assetId와 같은 값인 iconImageId가 있습니다.
iconImageId를 타이틀의 achievements2017.xml 구성에 복사합니다.
이 명령의 테이블에는 ASSET ID, CDN FILENAME, WIDTH, HEIGHT, IMAGE TYPE, PUBLIC이 표시됩니다. 전체 CDN URL과 기타 필드를 보려면 JSON을 사용하세요. download는 매니페스트를 반환합니다. --asset-id의 경우 assetId, destination, imagePath, thumbnailPath, imageBytes, thumbnailBytes가 있는 개체이고, --all의 경우 그러한 개체의 배열입니다. 테이블에는 ASSET ID와 DESTINATION이 표시됩니다. 이름이 같은 파일은 대체되고, 자산 폴더의 다른 파일은 유지됩니다. 다운로드가 실패하면 해당 자산의 기존 파일은 그대로 남습니다. --all을 사용한 경우 이미 다운로드된 폴더는 유지됩니다. 실패한 명령은 1로 종료하고 오류를 stderr에 씁니다. 서비스가 이미지를 거부하면 오류에 각 유효성 검사 메시지가 나열됩니다.

프로덕션 안전 및 업로드 복구

모든 업로드는 같은 파일이라도 새 이미지를 등록하며, CLI는 업로드를 절대 다시 시도하지 않습니다. upload가 Upload outcome unknown을 보고하면 이미지가 등록되었을 수 있습니다. 다시 업로드하기 전에 stderr에 출력된 get 또는 list 명령을 실행하고, 이미지를 찾으면 기존 자산 ID를 사용하세요. 등록 요청이 전송되기 전에 Ctrl+C를 누르면 아무것도 등록되지 않습니다. 전체 이미지와 썸네일을 검사하려면 다운로드하세요.
upload는 이미지를 등록하기 전에 묻지 않으며, --confirm은 이 명령에 적용되지 않습니다. 안전 및 파괴적 작업을 참조하세요.
마지막 수정일 2026년 11월 19일