xbox xbl achievement-image は、タイトルの実績用の PNG 画像をアップロードし、そのタイトルに登録されている
画像を読み取ります。--scid には、タイトルのサービス構成識別子 (SCID) を指定します。
upload は、タイトルの実績の構成に設定する iconImageId を返します。
オプション
例
画像をアップロードします。upload から返された assetId を渡して画像を確認し、画像とそのサムネイルを
achievement-images/<assetId>/ にダウンロードします。
出力
upload と get は画像オブジェクトを 1 つ返し、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 は upload には適用されません。
安全性と破壊的な操作を参照してください。