跳转到主要内容
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日