SuperAPI AI 工具集

asc-app-previews

部署与运维

查看项目

更新于 10-16 01:48

技能介绍

用途:通过 asc CLI 管理 App Store 应用预览视频集与视频上传,适合需要为本地化版本配置预览视频的发布流程。

主要能力:列出某本地化的预览集;创建预览集;列出集内预览;上传预览视频。创建预览集需指定 --localization-id 与 --preview-type,--preview-type 原始值不带 APP_ 前缀,常见值有 IPHONE_67、IPHONE_65、IPAD_PRO_3GEN_129、APPLE_TV、APPLE_VISION_PRO、DESKTOP。上传接受 .mp4、.mov、.m4v,可用 --preview-frame-time-code 设置商店展示的封面帧。上传为三步 API 流程:POST reserve → PUT chunks → PATCH MD5 confirm。

状态字段:AppPreview 有两个独立状态字段。assetDeliveryState 表示上传进度(AWAITING_UPLOAD、UPLOAD_COMPLETE、COMPLETE、FAILED);videoDeliveryState 表示视频编码(AWAITING_UPLOAD、UPLOAD_COMPLETE、PROCESSING、COMPLETE、FAILED),其中 PROCESSING 为预览视频特有。videoDeliveryState 为 COMPLETE 表示视频就绪。JSON 输出会省略空字段,mimeType 中的斜杠被转义为 /。

常用命令:asc app-preview-sets list --localization-id <LOCALIZATION_ID>;asc app-preview-sets create --localization-id <LOCALIZATION_ID> --preview-type <PREVIEW_TYPE>;asc app-previews list --set-id <SET_ID>;asc app-previews upload --set-id <SET_ID> --file path/to/preview.mp4 [--preview-frame-time-code 00:00:05]。响应内含 affordances 的现成后续命令。典型流程:先用 asc version-localizations list 查询本地化 ID,再创建预览集、上传视频并检查处理状态。限制:需本地安装并配置 asc CLI;预览类型取值与截图显示类型不同;视频必须等待编码完成。