mcpField
A
asc-app-previews

asc-app-previews

github.com/tddworks营销与增长590 次安装5 周前更新
代码仓库

关于 asc-app-previews

这是一个通过 `asc` 命令行管理 App Store 预览视频集和视频上传的技能，适用于维护应用商店本地化预览的开发者。它涵盖创建预览集、上传视频及查看上传和编码状态。

主要功能

  1. 01列出本地化预览集
  2. 02按设备类型创建预览集
  3. 03查看预览视频
  4. 04上传视频并设置海报帧
  5. 05区分上传与视频处理状态

适用场景

  1. 01为目标设备创建 App Store 预览集
  2. 02上传 MP4、MOV 或 M4V 预览视频
  3. 03检查视频是否完成编码

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-app-previews

安装后在 Claude Code 中输入/asc-app-previews确认已加载。

附带文件references/preview-types.md

详细介绍

asc App 预览

通过 asc CLI 管理 App Store 预览视频集和视频上传。

命令

列出某个本地化版本的预览集
asc app-preview-sets list --localization-id <LOCALIZATION_ID>
创建预览集
asc app-preview-sets create \
  --localization-id <LOCALIZATION_ID> \
  --preview-type <PREVIEW_TYPE>

--preview-type 原始值不带 APP_ 前缀，与屏幕截图显示类型不同。 常见值：IPHONE_67、IPHONE_65、IPAD_PRO_3GEN_129、APPLE_TV、APPLE_VISION_PRO、DESKTOP。

有关按设备分组的所有有效值，请参阅 preview-types.md。

列出某个预览集中的预览
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]
  • 接受的格式：.mp4、.mov、.m4v
  • --preview-frame-time-code 用于设置在 App Store 中显示的海报帧
  • 上传分为 3 步 API 流程：POST 预留 → PUT 分块 → PATCH MD5 确认

状态字段

AppPreview 有两个独立的状态字段（与只有一个状态字段的屏幕截图不同）：

字段状态含义
assetDeliveryStateAWAITING_UPLOAD、UPLOAD_COMPLETE、COMPLETE、FAILED上传进度
videoDeliveryStateAWAITING_UPLOAD、UPLOAD_COMPLETE、PROCESSING、COMPLETE、FAILED视频编码

videoDeliveryState: "COMPLETE" = 视频已就绪。PROCESSING 是预览专有的状态（屏幕截图中没有）。

值为 nil 的字段会从 JSON 输出中省略。包含 / 的 mimeType 值会由 JSONEncoder 转义为 \/（例如 "video\/mp4"）。

CAEOAS 便捷操作

每个 JSON 响应都包含 affordances，其中提供可直接运行的后续命令：

AppPreviewSet：

{
  "affordances": {
    "listPreviews":    "asc app-previews list     --set-id <SET_ID>",
    "listPreviewSets": "asc app-preview-sets list --localization-id <LOCALIZATION_ID>"
  }
}

AppPreview：

{
  "affordances": {
    "listPreviews": "asc app-previews list --set-id <SET_ID>"
  }
}

典型工作流

# 1. Find the localization ID
asc version-localizations list --version-id <VERSION_ID> --output table

# 2. Create a preview set for the target device
asc app-preview-sets create \
  --localization-id <LOCALIZATION_ID> \
  --preview-type IPHONE_67

# 3. Upload the video (copy --set-id from affordances in step 2)
asc app-previews upload \
  --set-id <SET_ID> \
  --file preview.mp4 \
  --preview-frame-time-code 00:00:05

# 4. Check processing state
asc app-previews list --set-id <SET_ID> --pretty

评论

支持 Markdown