REMOTION モーションデザイン — 実装スキル
1. コーディング前の確認
CLAUDE.md、MASTER_PROMPT.md、アーキテクチャドキュメントを読む。- 実際のRemotion/React/TypeScriptのバージョンとパッケージマネージャーを確認する。
- 既存のエントリポイントとコンポジションレジストリを見つける。
- リポジトリの規約に従う。必要なく依存関係を変更しない。
beyond-video、スクリプト、ストーリーボード、スタイルバイブルの出力を制作仕様として使用する。- メモリに頼らず、使用するAPIをインストール済みのRemotionソース(例:リファレンスクローンの
packages/core/src)に対して検証する。
2. コンポジションプロファイル
デフォルト:
- width: 1080
- height: 1920
- fps: 60
- aspect: 9:16
- duration: フレーム単位の正の整数
すべてのコンポジションには一意のIDと明示的なメタデータが必要です。理由なく複数のレイヤーで異なるFPS値を保存しないでください。
<Composition> は id、fps、width、height、durationInFrames、defaultProps、オプションで calculateMetadata(プロップからの動的なduration/metadata)と schema を受け入れます。durationInFrames は正の値でなければなりません。
3. タイムラインエンジニアリング
- デュレーションと開始フレームは集中管理されたデータ/設定に保持する。
- 1つのフレーム間隔規則を使用する。
[start, end)を推奨する。 - シーンの
durationInFramesは正の値でなければなりません。 - コンポジションの合計durationがすべてのシーンと末尾/クロージングを収容していることを確認する。
- 重複とギャップを検証する。トランジション/コンポジットのために意図されている場合のみ重複を許可する。
- 最終フレーム境界に浮動小数点数を使用しない。
4. 決定論的アニメーション — time/frame API(Remotion 4.x)
時刻ソース:
useCurrentFrame()— 現在のフレーム、0から始まるインデックス。コンポジションコンポーネント内でのみ使用可能。コンポジション外ではエラーをスローする。useVideoConfig()—{width, height, fps, durationInFrames, id, defaultProps, defaultVideoImageFormat, ...}を返す。コンポジション外ではエラーをスローする。
補間とスプリング:
interpolate(input, inputRange, outputRange, options?)— number、string、boolean、array出力のオーバーロード。オプション:easing、extrapolateLeft/extrapolateRight('extend' | 'identity' | 'clamp' | 'wrap')、output、outputType、posterize。モーションが範囲を超えて実行されてはならない場合はクランプ補外を使用する。spring({frame, fps, config?, from=0, to=1, durationInFrames?, durationRestThreshold?, delay=0, reverse=false})。SpringConfig:damping(デフォルト10)、mass(1)、stiffness(100)、overshootClamping(false)。damping <= 0の場合、アニメーションは決して落ち着かず(無限ループエラー)。measureSpring({fps, config?, threshold=0.005})— スプリングが落ち着くまでのフレーム数。threshold=0はInfinityを返す。
ルール:
- モーションはフレームとプロップの関数でなければならない。
- パーティクル/ノイズ/ランダム値をシードする。
- 動画モーションの主要なソースとして、
setInterval、setTimeout、requestAnimationFrame、Date.now()、自己実行CSSキーフレームを避ける。 - コンポジションのレンダリング中にネットワークデータを取得しない。
- 不安定なURLやログインが必要なURLからのオーディオ/ビデオを含めない。
delayRender(label?, options?)はcontinueRender(handle)が呼び出されるまでレンダリングを保持します(例:非同期アセット)。タイムアウトはCLI--timeoutで設定します。
5. Sequence、Series、ローカルフレームとグローバルフレーム
これは最も間違えられやすいルールです。かつて Series.Sequence 内のコンポーネントがグローバルフレームを計算してしまったバグが実際に発生しました:
<Sequence>内では、useCurrentFrame()はSequenceの開始位置を基準とした相対フレーム(frame - (cumulatedFrom + relativeFrom)) * playbackRateを返します。Sequence内のコンポーネントはグローバルフレームを見ることができません。<Sequence>のプロップ:from?、name?、durationInFrames?(正の値でなければならず、loopを使用する場合は必須)、layout('absolute-fill'|'none')、premountFor、loop、および切り抜きプロップ(layout="absolute-fill"の場合のみ)。<Series.Sequence>は<Series>内でのみ使用できます。<Series>外でSeries.Sequenceを使用すると「このコンポーネントは<Series />コンポーネント内になければなりません。」というエラーがスローされます。- 2つの有効なルーティングパターンがあります。1つを選択し、一貫して使用します:
- グローバルフレームルーター(ビデオプロジェクトで使用):1つのルーターコンポーネントがグローバル
useCurrentFrame()を使用し、その[start, end)範囲でビートを選択します。ビートコンポーネントはグローバルフレームから計算します。 - Series:各
Series.Sequenceが1つのビートを保持します。ビートコンポーネントはローカルフレーム(Sequenceの開始位置で0)から計算します。
- グローバルフレームルーター(ビデオプロジェクトで使用):1つのルーターコンポーネントがグローバル
- 明示的な理由なく、1つのコンポジション内で両方のパターンを混在させないでください。
6. シーン/コンポーネント構造
- 1つのシーンは1つのナラティブ/ビジュアルの責任を持つ。
- シーンプロップはTypeScriptで定義する。
- 再利用可能なコンポーネントは明確なビジュアルタスクを解決する。
- ビデオ全体を1つのファイルで保持するのは避ける。
- コンテンツ設定、レンダラー、スタイルトークン、アセット参照を分離する。
- オプションのアセットには設計されたフォールバックを追加する。重要なアセットがない場合は隠さない。
7. メディアコンポーネントとアセット
<Img src>—onErrorなしで読み込みに失敗した画像はレンダリングをキャンセルします(cancelRender)。重要なアセットには常にonErrorを提供するか、レンダリング前にアセットが存在することを確認する。staticFile(path)—public/内のファイルにマッピングします。すべてのローカルアセット(画像、オーディオ、ビデオ)に使用します。<Audio>— キューシートをプロップにマッピングする方法についてはsound-designを参照してください(trimBefore/After— 古いエイリアスstartFrom/endAt—volume、playbackRate)。タイムライン上のキューの位置は<Sequence from>で設定します。トリムプロップはファイルのどの部分を再生するかを切り取るだけです。<Audio>にはmutedプロップはありません。ミュートはCLIフラグ(--muted)です。<Video>/<OffthreadVideo>と<Still>も同じフレームルールに従います。メディアの長さはフレームからスケジュールされ、ファイルのメタデータからではありません。
8. 2Dモーション
必要に応じてSVG/シェイプ/CSS/ラスターを使用します。アンカー、トランスフォームの原点、アンチエイリアシング、レイヤリング、クリッピング、セーフエリアに注意してください。すべてのトランスフォームはフレーム駆動でなければなりません。
9. ピクセルアートとスティックマンサポート
ピクセルアート:
- 論理キャンバスとピクセルスケールを固定する。
- スプライトを拡大するときは最近傍補間を使用する。
- 必要に応じて位置をグリッドにスナップする。
- パレットとスプライト寸法を固定する。
- ぼかしとサブピクセルちらつきを避ける。
スティックマン:
- プロポーションとピボットを一貫させる。
- プロジェクトの規模が許す場合はポーズ/リグライブラリを使用する。
- シルエットとジェスチャーを読み取れるようにアニメーション化する。
- 表情/ポーズをストーリービートと同期させる。
歩行サイクル、フォロースルー、アイドルモーションについては character-animation を参照してください。
10. 3Dモーション
- 創造的な価値がある場合のみ3Dを追加する。
three、@react-three/fiber、@remotion/threeのバージョンとそれらのドキュメントを確認する。- Remotion ThreeCanvas統合については、インストールされているAPIバージョンのフレーム駆動アプローチに従う。リアルタイムR3Fパターンが自動的に決定論的であると想定しない。
- カメラ、トランスフォーム、マテリアル、ライティング、パーティクルをフレームから駆動する。
- レンダラー/ヘッドレス互換性、テクスチャサイズ、ジオメトリ、計算コストを考慮する。
- 読みやすさと保守性に役立つ場合は、3Dレイヤーを2Dタイポグラフィ/オーバーレイから分離する。
- 3Dシーンを詳細にディレクションする方法については
3d-scene-directorを参照してください。
11. タイポグラフィとトランジション
- 階層と可読性を優先する。
- トランジションで重要なコピーを隠さない。
- すべてのトランジションは2つのビートを接続する。機能なしにエフェクトを追加しない。
- モーションカーブと強度をスタイルバイブル全体で一貫させる。
- テキストの長さを読み取り時間に合わせる。
12. クロージングの実装
beyond-video ワークシートに従って、クロージングのロゴとCTAを実装する。ロゴは公式アセットまたは承認されたプレースホルダーから提供されなければなりません。コピー、タイミング、モチーフ、コンポジションは、対象のビデオのために作られたように感じられる必要があります。
13. 引き渡し前のQA
コンポジションID、メタデータ、フレーム範囲、インポート、型、静的アセット、フォント、スタイルの一貫性、セーフエリア、クロージング、アセットライセンスを確認する。利用可能なlint/typecheck/テストを実行する。MP4をレンダリングしない。コミット/プッシュしない。
出力形式
- コンポジションレジストリ:ID、1080×1920、60 FPS、durationInFrames、シーンリスト+フレーム範囲。
- 使用したAPI:API名+関連シグネチャ+検証場所(インストール済みRemotionバージョン)。
- フレームルーティングパターン:グローバルまたはSeries。1つの選択、コンポジション全体で一貫させる。
- アセットレジスタ:ファイル、
staticFile、重要アセットごとのフォールバック/onError。 - QAチェックリスト+typecheck/lintの結果。
ミニ例
グローバルフレームルーター(ビデオプロジェクトパターン):
const frame = useCurrentFrame();
const beat = BEATS.find((b) => frame >= b.start && frame < b.end);
return (
<AbsoluteFill>
{beat?.id === 'S01-B01' && <Hook />}
{beat?.id === 'S01-B02' && <Problem />}
</AbsoluteFill>
);
測定されたデュレーションを持つスプリング:
const settle = measureSpring({fps, config: {damping: 12}});
const progress = spring({frame, fps, config: {damping: 12}});
失敗モード
Series.Sequence内のコンポーネントがグローバルフレームを計算する → 間違ったビート、シーンが間違ったタイミングで表示される。修正:ローカルフレームから計算するか、グローバルフレームルーターに切り替える。Series.Sequenceを<Series>なしで使用する → レンダリング時にスローされる。<Series>でラップするか、<Sequence>を直接使用する(Series.Sequenceではなく)。springをdamping <= 0で使用する → アニメーションが決して落ち着かない。damping > 0を維持する。onErrorなしで画像がない → レンダリングがキャンセルされる。onErrorを追加するか、レンダリング前にアセットが存在することを確認する。useCurrentFrame()/useVideoConfig()をコンポジション外で使用する → スローされる。コンポジションコンポーネント内でのみ呼び出す。