Remotion
Remotion は React コンポーネントを動画に変換します。JSX を記述すると、Remotion が固定の fps でフレームごとにコンポーネントを呼び出し、生成されたフレームを MP4(または他の形式)に結合します。
コアの考え方
Remotion はフレーム番号と空白のキャンバスを提供します。あなたの React コンポーネントがそのフレームに何を描画するかを決定します。
従来の命令型アニメーションタイムラインはありません。時間は 数値(frame)であり、コンポーネントはその数値と props の純関数です。そのため、アニメーションは useCurrentFrame() で駆動する必要があります。CSS トランジションや setTimeout はレンダリング中に非決定的になり、ちらつきや同期ずれを引き起こします。
このスキルを使うべき時
- ユーザーが Remotion プロジェクト(
remotion.config.tsまたはpackage.json内の@remotion/*)を持っていて、Composition の構築、変更、デバッグをしたい場合 - ユーザーが「Remotion で動画を作ろう / コードで / プログラムで」と言った場合
- ユーザーが Remotion のエラーを貼り付けたり、
interpolate、spring、Sequence、useCurrentFrame、Compositionなどについて質問した場合 - ユーザーが既存の Remotion プロジェクトをレンダリングしたい、または Lambda レンダリングをセットアップしたい場合
使用すべきでない時
- AI モデル(Veo, Sora, Runway, Kling, HeyGen)で動画を生成する場合 → video スキルを使用
- 既存の動画ファイルを編集(カット/トリム/結合)する場合 → ffmpeg を使用(Remotion ではありません)
- ライブ配信 → Remotion はオフラインレンダリングのみ
ワークフロー
-
プロジェクトを検出またはスキャフォールドします。
- 新規プロジェクト:
npx create-video@latest(対話形式 — Hello World、Blank、JavaScript、TikTok などのテンプレートを選択) - 既存:
remotion.config.ts、src/Root.tsx、package.json内の@remotion/cliを確認。Remotion のメジャーバージョンに注意 — API は進化しており、適切なドキュメント URL はhttps://www.remotion.dev/docs(最新)またはバージョン固定のページになります。
- 新規プロジェクト:
-
Composition を見つけるか作成します。 Composition は
src/Root.tsxで<Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />を使って登録します。idは CLI がレンダリング時に名前指定するものです。 -
useCurrentFrame+useVideoConfigを使用してコンポーネントを構築し、時間とメタデータを扱います。<AbsoluteFill>でレイアウトを構成し、<Sequence>で時間をスライスします。 -
Studio でプレビュー:
npx remotion studio(自動リロード)。フレームを単独で「テスト」しようとしないでください — Studio を開いてください。 -
レンダリング:
npx remotion render <CompositionId> [output.mp4]。デフォルトのコーデックは H.264 / MP4 です。フラグとプログラム API については references/rendering.md を参照してください。
クイック API リファレンス
詳細についてはリンク先のファイルを参照してください — タスクで必要になったときにのみ読み込んでください。
| トピック | ファイル |
|---|---|
| Composition、フック、Sequence、AbsoluteFill、レイアウト | references/core-concepts.md |
interpolate、spring、Easing、スタガリング、一般的なアニメーションパターン | references/animation.md |
レンダリング: CLI フラグ、@remotion/renderer、Lambda、コーデック、props | references/rendering.md |
音声/動画/画像: <Audio>、<Video>、<Img>、<OffthreadVideo>、キャプション | references/media.md |
プロジェクト設定、ファイル規約、remotion.config.ts | references/project-setup.md |
| 一般的なパターン: タイピングアニメーション、ローワーサード、データ駆動、パララックス | references/patterns.md |
厳格なルール
useCurrentFrame()でアニメーションさせます。setTimeout、requestAnimationFrame、CSStransitionは絶対に使用しないでください。レンダリング中は各フレームがヘッドレスブラウザで独立してレンダリングされるため、これらはちらつきます。durationInFramesは必須で、整数でなければなりません。 合計秒数 =durationInFrames / fps。- コンポーネントは純粋に保ちます。 トップレベルの副作用、決定論的シードなしの
Math.random()は禁止 — 同じフレームは常に同じピクセルを生成しなければなりません。 - レンダリング中にフェッチしないでください。
delayRender()/continueRender()を使用してデータ読み込み中にフレームの準備ができるのをブロックするか、事前にフェッチして props で渡します。 - 可能な場合は
<Video>ではなく<OffthreadVideo>を使用して、レンダリング中の動画読み込みを非ブロッキングにします(より高速、メモリ使用量が少ない)。 - 動的データは
--props(CLI)またはinputProps(Studio/プログラム)で渡し、ファイルを編集しないでください。
よくあるエラー
| エラー / 症状 | 原因 | 修正 |
|---|---|---|
| MP4 と Studio プレビューでモーションがちらつく / 一致しない | CSS トランジションまたはフレーム駆動でないアニメーションを使用した | interpolate(frame, ...) または spring({ frame, fps }) に置き換える |
| 「Composition not found」 | ID のタイポまたは <Composition> 登録の欠落 | src/Root.tsx を確認 |
| レンダリングがハングする | 保留中の delayRender() が continueRender() を呼び出していない | 未解決の Promise を見つけ、try/finally を追加 |
| 長い動画でメモリ不足 | <Video> がフレームをメモリに保持している | <OffthreadVideo> に切り替える |
| 音声が同期しない | 音声ファイルの fps 不一致、または開始フレームが間違っている | <Audio> を <Sequence from={...}> でラップ |
確認
変更を行った後は、必ず以下を実行してください:
npx remotion studioを実行し、タイムラインをスクラブして、複数のフレーム(開始、中間、終了)で変更が正しく見えることを確認する- プログラムによる変更の場合は、短いテストセグメントをレンダリングする:
npx remotion render <id> out.mp4 --frames=0-60 - 型チェック: プロジェクトが TypeScript の場合は
npx tsc --noEmit
これらを行わずに成功を主張しないでください。コードがコンパイルできることと、動画が正しく見えることは別です。