跳轉到主要內容
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日