使用するタイミング
このスキルは以下の場合に使用します:
- コードからプログラムで動画を作成する場合(生成AI動画ではありません)
- データ駆動型の動画コンテンツ(チャート、統計、パーソナライズ動画)を構築する場合
- テンプレートとデータからバッチ動画を生成する場合
- アニメーションを使用したソーシャルコンテンツ(TikTok、Reels、Shorts)を作成する場合
- 正確な制御が必要な製品デモや説明動画を構築する場合
クイックスタート
1. 新しいプロジェクトを作成
python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video
2. コンポジションを記述
src/Composition.tsx を編集します - これが React コンポーネントとして定義された動画です。
3. Studio でプレビュー
python3 Skills/remotion/scripts/remotion_cli.py studio my-video
4. MP4 にレンダリング
python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4
コアコンセプト
コンポジション
コンポジションは動画の寸法、長さ、fps を定義します:
<Composition
id="MyVideo"
component={MyComponent}
durationInFrames={300} // 30fps で10秒
fps={30}
width={1920}
height={1080}
/>
フレームベースのアニメーション
すべてのアニメーションは useCurrentFrame() を使用する必要があります。CSS アニメーションは禁止です。
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
シーケンス
要素の表示タイミングを指定するには <Sequence> を使用します:
<Sequence from={30} durationInFrames={60}>
<Title />
</Sequence>
ルールリファレンス
詳細なパターンについては以下を参照してください(上流の Remotion スキルから読み込まれます):
| ルール | 説明 |
|---|---|
references/animations.md | フレームベースアニメーションの基礎 |
references/timing.md | スプリング、イージング、補間曲線 |
references/compositions.md | コンポジション、スチル、フォルダの定義 |
references/sequencing.md | 要素のタイミングと順序付け |
references/videos.md | 動画の埋め込み - トリミング、音量、速度 |
references/audio.md | オーディオ処理 - インポート、トリミング、音量 |
references/assets.md | 画像、フォント、静的ファイル |
references/transitions.md | シーントランジション |
references/text-animations.md | タイポグラフィアニメーションパターン |
references/charts.md | データ可視化パターン |
references/display-captions.md | TikTok スタイルのキャプション |
CLI コマンド
# プロジェクト管理
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output path]
python3 Skills/remotion/scripts/remotion_cli.py list
# レンダリングオプション
--composition ID # レンダリングする特定のコンポジション(デフォルト: 最初)
--output PATH # 出力ファイルパス(デフォルト: out/video.mp4)
--fps N # FPS の上書き
--width N # 幅の上書き
--height N # 高さの上書き
--codec CODEC # h264, h265, vp8, vp9, prores(デフォルト: h264)
よく使うパターン
フェードイン/アウト
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
スプリングアニメーション(自然な動き)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // スムーズ、バウンスなし
});
要素のずらし表示
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
データ駆動型動画
type VideoProps = { title: string; stats: number[] };
export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
// プロパティに基づいてアニメーション
};
// Root.tsx 内:
<Composition
id="DataVideo"
component={DataVideo}
defaultProps={{ title: "Q4 結果", stats: [10, 20, 30] }}
// ...
/>
Zo との統合
バッチレンダリング
/zo/ask を使用して複数の動画を並行レンダリングします:
for row in data:
# 各呼び出しで異なるプロパティでレンダリング
await render_video(row)
出力場所
プロジェクトは一貫性のために Sites/<name>/ に配置されます(Zo のサイトシステムと連携)。
レンダリングされた動画は Sites/<name>/out/ に出力されます。
制約
- CSS アニメーション禁止 - 正しくレンダリングされません
- Tailwind アニメーションクラス禁止 - 同様の問題
- フレームベースのみ - すべてのモーションは
useCurrentFrame()から - CPU 負荷が高い - レンダリングに時間がかかります; 複雑な動画ほどレンダリング時間が長くなります
- Node.js 必須 - Remotion は Node 環境を必要とします(Zo ではすでに利用可能)