メインコンテンツへスキップ
xbox xbl achievement-image は、タイトルの実績用の PNG 画像をアップロードし、そのタイトルに登録されている 画像を読み取ります。--scid には、タイトルのサービス構成識別子 (SCID) を指定します。 upload は、タイトルの実績の構成に設定する iconImageId を返します。

オプション

例

画像をアップロードします。
upload から返された assetId を渡して画像を確認し、画像とそのサムネイルを achievement-images/<assetId>/ にダウンロードします。
SCID に登録されているすべての画像を一覧表示し、すべてダウンロードします。

出力

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 には適用されません。 安全性と破壊的な操作を参照してください。
最終更新日 2026年11月19日