Stitch から Remotion へのウォークスルー動画生成
あなたはビデオ制作のスペシャリストであり、アプリデザインから魅力的なウォークスルー動画を作成することに注力します。Stitch の画面取得機能と Remotion のプログラムによる動画生成機能を組み合わせ、スムーズでプロフェッショナルなプレゼンテーションを生み出します。
概要
このスキルを使用すると、プロフェッショナルなトランジション、ズーム効果、コンテキストに応じたテキストオーバーレイを備えたウォークスルー動画をアプリ画面から作成できます。ワークフローは、Stitch プロジェクトから画面を取得し、それらを Remotion 動画構成として調整します。
前提条件
必須:
- Stitch MCP Server へのアクセス
- Remotion MCP Server (または Remotion CLI) へのアクセス
- Node.js と npm がインストールされていること
- デザイン済みの画面を持つ Stitch プロジェクト
推奨:
- Remotion の動画機能に関する知識
- React コンポーネントの理解 (Remotion は React を使用します)
取得とネットワーキング
ステップ 1: 利用可能な MCP サーバーを確認する
list_tools を実行して、利用可能な MCP サーバーとそのプレフィックスを特定します:
- Stitch MCP:
stitch:またはmcp_stitch:プレフィックスを探す - Remotion MCP:
remotion:またはmcp_remotion:プレフィックスを探す
ステップ 2: Stitch プロジェクト情報を取得する
-
プロジェクト検索 (プロジェクト ID が提供されていない場合):
[stitch_prefix]:list_projectsをfilter: "view=owned"で呼び出す- タイトルで対象プロジェクトを特定する (例: "Calculator App")
nameフィールドからプロジェクト ID を抽出する (例:projects/13534454087919359824)
-
画面取得:
[stitch_prefix]:list_screensをプロジェクト ID (数値のみ) で呼び出す- 画面タイトルを確認して、ウォークスルーに含めるすべての画面を特定する
- 各画面の
nameフィールドから画面 ID を抽出する
-
画面メタデータの取得: 各画面に対して:
[stitch_prefix]:get_screenをprojectIdとscreenIdで呼び出す- 以下を取得する:
screenshot.downloadUrl— 動画用のビジュアルアセットhtmlCode.downloadUrl— オプション: テキスト/コンテンツの抽出用width,height— 適切なスケーリングのための画面サイズ- 画面のタイトルと説明 (テキストオーバーレイ用)
-
アセットのダウンロード:
web_fetchまたはcurlを使用したBashでスクリーンショットをダウンロードする- ステージングディレクトリ
assets/screens/{screen-name}.pngに保存する - 意図したウォークスルーの流れの順序でアセットを整理する
ステップ 3: Remotion プロジェクトをセットアップする
-
既存の Remotion プロジェクトを確認:
remotion.config.tsまたは Remotion 依存関係を含むpackage.jsonを探す- 存在する場合は、そのプロジェクト構造を使用する
-
新しい Remotion プロジェクトを作成する (必要な場合):
npm create video@latest -- --blank- TypeScript テンプレートを選択する
- 専用の
video/ディレクトリにセットアップする
-
依存関係をインストールする:
cd video npm install @remotion/transitions @remotion/animated-emoji
動画構成戦略
アーキテクチャ
以下のコンポーネントを持つモジュール式の Remotion 構成を作成します:
-
ScreenSlide.tsx— 個別の画面表示コンポーネント- Props:
imageSrc,title,description,width,height - 機能: ズームインアニメーション、フェードトランジション
- 持続時間: 設定可能 (デフォルトは画面あたり 3〜5 秒)
- Props:
-
WalkthroughComposition.tsx— メイン動画構成- 複数の
ScreenSlideコンポーネントをシーケンス化する - 画面間のトランジションを処理する
- テキストオーバーレイと注釈を追加する
- 複数の
-
config.ts— 動画設定- フレームレート (デフォルト: 30 fps)
- 動画サイズ (Stitch 画面サイズに合わせるか適切にスケーリング)
- 総持続時間の計算
トランジション効果
プロフェッショナルな効果には Remotion の @remotion/transitions を使用します:
-
フェード: 画面間のスムーズなクロスフェード
import {fade} from '@remotion/transitions/fade'; -
スライド: 方向性のあるスライドトランジション
import {slide} from '@remotion/transitions/slide'; -
ズーム: 強調のためのズームイン/アウト効果
- スムーズなズームには
spring()アニメーションを使用する - 重要な UI 要素に適用する
- スムーズなズームには
テキストオーバーレイ
Remotion のテキストレンダリングを使用して、コンテキスト情報を追加します:
- 画面タイトル: 各フレームの上部または下部に表示する
- 機能コールアウト: アニメーションポインターで特定の UI 要素を強調する
- 説明文: 各画面の説明テキストをフェードインする
- 進行状況インジケーター: ウォークスルー内の現在の画面位置を表示する
実行手順
ステップ 1: 画面アセットを収集する
- 対象の Stitch プロジェクトを特定する
- プロジェクト内のすべての画面を一覧表示する
- 各画面のスクリーンショットをダウンロードする
- ウォークスルーの流れの順序に整理する
- マニフェストファイル (
screens.json) を作成する:
{
"projectName": "電卓アプリ",
"screens": [
{
"id": "1",
"title": "ホーム画面",
"description": "数字パッド付きのメイン電卓インターフェース",
"imagePath": "assets/screens/home.png",
"width": 1200,
"height": 800,
"duration": 4
},
{
"id": "2",
"title": "履歴ビュー",
"description": "以前の計算結果の表示",
"imagePath": "assets/screens/history.png",
"width": 1200,
"height": 800,
"duration": 3
}
]
}
ステップ 2: Remotion コンポーネントを生成する
Remotion のベストプラクティスに従って動画コンポーネントを作成します:
-
ScreenSlide.tsxを作成:- アニメーションには
useCurrentFrame()とspring()を使用する - ズームとフェード効果を実装する
- 適切なタイミングでテキストオーバーレイを追加する
- アニメーションには
-
WalkthroughComposition.tsxを作成:- 画面マニフェストをインポートする
<Sequence>コンポーネントで画面をシーケンス化する- 画面間にトランジションを適用する
- 適切なタイミングとオフセットを計算する
-
remotion.config.tsを更新:- 構成 ID を設定する
- 動画サイズを設定する
- フレームレートと持続時間を設定する
参考リソース:
- 出発点として
resources/screen-slide-template.tsxを使用する - 完全性を確認するには
resources/composition-checklist.mdに従う examples/walkthrough/ディレクトリの例を確認する
ステップ 3: プレビューと調整
-
Remotion Studio を起動:
npm run dev- ブラウザベースのプレビューが開く
- リアルタイムでの編集と調整が可能
-
タイミングを調整:
- 各画面が適切な表示時間を持つことを確認する
- トランジションがスムーズであることを確認する
- テキストオーバーレイのタイミングを確認する
-
アニメーションを微調整:
- ズーム効果のスプリング設定を調整する
- トランジションのイージング関数を変更する
- テキストが常に読みやすいことを確認する
ステップ 4: 動画をレンダリングする
-
Remotion CLI を使用してレンダリング:
npx remotion render WalkthroughComposition output.mp4 -
代替: Remotion MCP を使用 (利用可能な場合):
- 構成の詳細を指定して
[remotion_prefix]:renderを呼び出す - 出力形式を指定する (MP4, WebM など)
- 構成の詳細を指定して
-
最適化オプション:
- 品質レベルの設定 (
--quality) - コーデックの設定 (
--codec h264またはh265) - 並列レンダリングの有効化 (
--concurrency)
- 品質レベルの設定 (
高度な機能
インタラクティブホットスポット
クリック可能な要素や重要な機能を強調表示します:
import {interpolate, useCurrentFrame} from 'remotion';
const Hotspot = ({x, y, label}) => {
const frame = useCurrentFrame();
const scale = spring({
frame,
fps: 30,
config: {damping: 10, stiffness: 100}
});
return (
<div style={{
position: 'absolute',
left: x,
top: y,
transform: `scale(${scale})`
}}>
<div className="pulse-ring" />
<span>{label}</span>
</div>
);
};
ナレーション統合
ウォークスルーにナレーションを追加します:
- 画面の説明からナレーションスクリプトを生成する
- テキスト読み上げを使用するか、音声を録音する
<Audio>コンポーネントで音声を Remotion にインポートする- 画面のタイミングをナレーションのペースに同期させる
動的テキスト抽出
Stitch の HTML コードからテキストを抽出して自動注釈を生成します:
- 各画面の
htmlCode.downloadUrlをダウンロードする - HTML を解析して主要なテキスト要素 (見出し、ボタン、ラベル) を抽出する
- 重要な UI 要素の自動コールアウトを生成する
- タイミング設定されたテキストオーバーレイとして構成に追加する
ファイル構造
project/
├── video/ # Remotion プロジェクトディレクトリ
│ ├── src/
│ │ ├── WalkthroughComposition.tsx
│ │ ├── ScreenSlide.tsx
│ │ ├── components/
│ │ │ ├── Hotspot.tsx
│ │ │ └── TextOverlay.tsx
│ │ └── Root.tsx
│ ├── public/
│ │ └── assets/
│ │ └── screens/ # ダウンロードされた Stitch スクリーンショット
│ │ ├── home.png
│ │ └── history.png
│ ├── remotion.config.ts
│ └── package.json
├── screens.json # 画面マニフェスト
└── output.mp4 # レンダリングされた動画
Remotion スキルとの統合
Remotion は、ベストプラクティスを定義する独自の Agent Skills を維持しています。高度なテクニックについてはこれらを確認してください:
- リポジトリ: https://github.com/remotion-dev/remotion/tree/main/packages/skills
- インストール:
npx skills add remotion-dev/skills
活用すべき主要な Remotion スキル:
- アニメーションのタイミングとイージング
- 構成アーキテクチャのパターン
- パフォーマンス最適化
- オーディオ同期
一般的なパターン
パターン 1: シンプルなスライドショー
フェードトランジションを使用した基本的なウォークスルー:
- 画面あたり 3〜5 秒
- クロスフェードトランジション
- 画面タイトル付きの下部テキストオーバーレイ
- 上部にプログレスバー
パターン 2: 機能ハイライト
特定の UI 要素に焦点を当てる:
- 特定の領域にズームイン
- 機能を指し示すアニメーション化された円/矢印
- 主要なインタラクションのスローモーション強調
- ビフォー/アフターの並列比較
パターン 3: ユーザーフロー
ステップバイステップのユーザージャーニーを表示:
- 方向性のあるスライドを使用した画面の順次フロー
- 番号付きのステップオーバーレイ
- ユーザーアクション (クリック、タップ) を強調
- アニメーションパスで画面をつなぐ
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| スクリーンショットがぼやける | ダウンロードした画像がフル解像度であることを確認する; screenshot.downloadUrl の品質設定を確認する |
| テキストの位置がずれる | 画面サイズが構成サイズと一致していることを確認する; 実際の画面サイズに基づいてテキストの位置を調整する |
| アニメーションがカクつく | フレームレートを 60fps に上げる; 適切な減衰設定で適切なスプリング構成を使用する |
| Remotion ビルドが失敗する | Node バージョンの互換性を確認する; すべての依存関係がインストールされていることを確認する; Remotion のドキュメントを確認する |
| タイミングがずれている | マニフェストで画面ごとの持続時間を調整する; Remotion Studio でプレビューする; 実際のユーザーでテストする |
ベストプラクティス
- アスペクト比を維持する: 実際の Stitch 画面サイズを使用するか、比例してスケーリングする
- 一貫したタイミング: 特定の画面を強調しない限り、画面の表示時間を一定に保つ
- 読みやすいテキスト: 十分なコントラストを確保する; 適切なフォントサイズを使用する; オーバーレイがごちゃごちゃしないようにする
- スムーズなトランジション: 自然な動きにはスプリングアニメーションを使用する; ぎこちないカットを避ける
- 徹底的にプレビューする: 最終レンダリングの前に必ず Remotion Studio でプレビューする
- アセットを最適化する: 画像を適切に圧縮する; 効率的な形式を使用する (UI には PNG、写真には JPG)
使用例
ユーザープロンプト:
私の Stitch プロジェクト「Calculator App」の画面を調べて、画面のウォークスルーを表示する remotion 動画を
作成してください。
エージェントのワークフロー:
- Stitch プロジェクトを一覧表示 → 「Calculator App」を見つける → プロジェクト ID を抽出
- プロジェクト内の画面を一覧表示 → すべての画面を特定 (Home, History, Settings)
- 各画面のスクリーンショットをダウンロード →
assets/screens/に保存 - 画面メタデータを含む
screens.jsonマニフェストを作成 - Remotion コンポーネントを生成 (
ScreenSlide.tsx,WalkthroughComposition.tsx) - Remotion Studio でプレビュー → タイミングとトランジションを調整
- 最終動画をレンダリング →
calculator-walkthrough.mp4 - 動画プレビューリンクとともに完了を報告
成功のためのヒント
- シンプルに始める: 複雑なアニメーションを追加する前に、基本的なフェードトランジションから始める
- Remotion パターンに従う: Remotion の公式スキルとドキュメントを活用する
- マニフェストファイルを使用する: 簡単に更新できるように画面データを JSON で整理する
- 頻繁にプレビューする: Remotion Studio を使用して問題を早期に発見する
- アクセシビリティを考慮する: キャプションを追加する; テキストが読みやすいことを確認する; 明確なビジュアルを使用する
- プラットフォームに最適化する: 動画サイズをターゲットプラットフォーム (YouTube, ソーシャルメディアなど) に合わせる
参考文献
- Stitch ドキュメント: https://stitch.withgoogle.com/docs/
- Remotion ドキュメント: https://www.remotion.dev/docs/
- Remotion スキル: https://www.remotion.dev/docs/ai/skills
- Remotion MCP: https://www.remotion.dev/docs/ai/mcp
- Remotion トランジション: https://www.remotion.dev/docs/transitions
使用タイミング
上記の主要なドメインや機能に関連するタスクに取り組む際に、このスキルを使用してください。
接続
- ドメイン: [[Design & Kreativitaet]]
- カテゴリー: [[UI & UX Design]]
- ナビゲーション: [[Skills Uebersicht]], [[Home]]