mcpField
A
asc-app-previews

asc-app-previews

github.com/tddworksマーケティング・グロース595 回インストール8 週間前に更新
リポジトリ

asc-app-previews について

`asc` CLIでApp Storeのプレビューセットと動画アップロードを管理するスキルです。ローカライズ済みストアプレビューを扱う開発者向けに、セット作成、動画のアップロード、配信状態の確認を支援します。

主な機能

  1. 01ローカライズ別のセット一覧
  2. 02デバイスタイプ別セット作成
  3. 03プレビュー動画の一覧表示
  4. 04動画アップロードとポスターフレーム指定
  5. 05アップロードとエンコード状態の確認

活用シーン

  1. 01対象デバイス用のプレビューセット作成
  2. 02MP4、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 アプリプレビュー

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 には、スクリーンショットの状態フィールドが 1 つだけなのとは異なり、独立した状態フィールドが 2 つあります。

フィールド状態意味
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 対応