いつ使用するか
Remotion のコードを読み書きするときは、プロジェクトのスキャフォールディングから最終動画のレンダリングまで、常にこのスキルをロードしてください。
避けるべき一般的な AI のミス
コミットする前に、すべての Remotion コードの変更を以下の再発する障害モードに対して確認してください。
- 非決定論的なランダム性 —
remotionのrandom(seed)を使用し、Math.random()、Date.now()、new Date()は決して使用しないでください。そうしないと、並列レンダリングでちらつきノイズが発生します。 - メモ化されていない
<Player>inputProps— 常にメモ化された props を渡してください。メモ化されていない props は、ツリー全体で再レンダリングの嵐を引き起こします。 - 非同期処理(フェッチ、フォントロード、測定)の周りでの
delayRender()/continueRender()の欠落 — これがないと、レンダリングは 30000 ミリ秒で停止します。 - キャプションの
inputRangeが単調増加でない —interpolateのinputRangeは厳密に増加する必要があります。短いクリップの場合は、フェードウィンドウにMath.min(10, Math.floor(duration / 3))を使用します。 - すべてに線形イージングを使用 — 自然な動きには
spring()を優先し、線形は明示的な技術的必要性がある場合のみ使用してください。 @remotion/google-fontsのインポート忘れ — すべてのフォントには明示的なloadFont({ weights, subsets })呼び出しが必要です。- モノリシックな単一コンポジション出力 — シーンを小さく焦点を絞ったコンポジションに分割し、
<Sequence>または<TransitionSeries>で構成してください。 - 非推奨の
startFrom/endAt— 代わりにtrimBefore/trimAfterを使用してください。
新しいプロジェクトのセットアップ
空のフォルダまたは既存の Remotion プロジェクトがないワークスペースの場合、以下を使用してスキャフォールディングします。
npx create-video@latest --yes --blank --no-tailwind my-video
my-video を適切なプロジェクト名に置き換えてください。
プレビューの開始
Remotion Studio を開始して動画をプレビューします。
npx remotion studio
オプション: 1フレームレンダリングチェック
レイアウト、色、タイミングを確認するために、CLI で単一フレームをレンダリングできます。簡単な編集、純粋なリファクタリング、または Studio や以前のレンダリングから十分な確信が得られている場合はスキップしてください。
npx remotion still [composition-id] --scale=0.25 --frame=30
30 fps では、--frame=30 は 1 秒のマークです(--frame は 0 ベースです)。
ルールインデックス
詳細な説明とコード例については、個別のルールファイルを参照してください。
コア
- core/compositions.md - コンポジション、スチル、フォルダ、デフォルトのプロパティ、動的メタデータの定義
- core/sequencing.md - シーケンスパターン - 遅延、トリミング、アイテムの持続時間制限
- core/timing.md - interpolate、ベジェイージング、スプリングを使用したタイミング
- core/animations.md - 基本的なアニメーションスキル
- core/trimming.md - アニメーションの先頭または末尾をトリミング
- core/parameters.md - Zod スキーマを使用して動画をパラメータ化可能にする
- core/calculate-metadata.md - コンポジションの持続時間、寸法、プロパティを動的に設定
- core/primitives.md - レイアウトとタイミングのプリミティブ: Loop、Freeze、Series、Null、IFrame、AnimatedImage、premount
メディア
- media/images.md - Img コンポーネントを使用した画像の埋め込み
- media/videos.md - 動画の埋め込み - トリミング、ボリューム、速度、ループ
- media/gifs.md - Remotion のタイムラインと同期した GIF の表示
- media/lottie.md - Lottie アニメーションの埋め込み
- media/transparent-videos.md - 透明な動画のレンダリング
- media/assets.md - 画像、動画、オーディオ、フォントのインポート
- media/light-leaks.md - ライトリークオーバーレイ効果
- media/3d.md - Three.js と React Three Fiber を使用した 3D コンテンツ
オーディオ
- audio/audio.md - オーディオとサウンドの使用 - インポート、トリミング、ボリューム、速度、ピッチ
- audio/voiceover.md - ElevenLabs TTS を使用した AI 生成ナレーション
- audio/audio-visualization.md - オーディオの可視化(スペクトルバー、波形、低音反応)
- audio/silence-detection.md - FFmpeg を使用した適応型無音検出
- audio/sfx.md - 効果音の使用
- audio/subtitles.md - キャプションと字幕の概要
- audio/get-audio-duration.md - Mediabunny を使用したオーディオファイルの長さの取得
- audio/ai-captions.md - AI 文字起こし: @remotion/openai-whisper、whisper-web、install-whisper-cpp
テキスト
- text/text-animations.md - タイポグラフィとテキストアニメーションパターン
- text/measuring-text.md - テキストの寸法測定、コンテナへのテキストのフィッティング
- text/fonts.md - Google Fonts とローカルフォントの読み込み
- text/google-fonts.md - @remotion/google-fonts のフォントごとのパッケージ(必要な weights/subsets を含む)
- text/display-captions.md - 画面へのキャプションのレンダリング
- text/import-srt-captions.md - SRT キャプションファイルのインポート
高度な機能
- advanced/maps.md - Mapbox を使用した地図の追加とアニメーション
- advanced/charts.md - チャートとデータ可視化(棒、円、折れ線、株価)
- advanced/transitions.md - シーントランジションパターン(基本)
- advanced/transitions-package.md - @remotion/transitions 完全リファレンス - プレゼンテーション、タイミング、カスタム
- advanced/tailwind.md - Remotion での TailwindCSS の使用
- advanced/measuring-dom-nodes.md - DOM 要素の寸法測定
- advanced/hdr.md - 色空間と HDR 出力: bt709、displayp3、rec2020、ProRes
ユーティリティ
- utilities/ffmpeg.md - 動画操作のための FFmpeg の使用
- utilities/can-decode.md - Mediabunny を使用した動画デコード可能性の確認
- utilities/extract-frames.md - 特定のタイムスタンプでのフレーム抽出
- utilities/get-video-dimensions.md - 動画ファイルの幅と高さの取得
- utilities/get-video-duration.md - 動画ファイルの長さ(秒)の取得
- utilities/transcribe-captions.md - キャプションの文字起こし
プロダクション
- production/delay-render.md - 非同期処理中にレンダリングを一時停止: delayRender、continueRender、cancelRender
- production/determinism.md - random(seed) を使用した決定論的レンダリング; Math.random / Date.now は使用しない
- production/rendering.md - @remotion/renderer Node SSR: bundle、selectComposition、renderMedia
- production/cli.md - npx remotion サブコマンドとフラグ(render、still、bundle、studio、benchmark)
- production/config.md - remotion.config.ts Config セッター(codec、CRF、concurrency、Webpack)
- production/lambda.md - AWS Lambda: deployFunction、deploySite、renderMediaOnLambda、コスト調整
- production/player.md - @remotion/player 埋め込み、PlayerRef、メモ化された inputProps、バッファイベント
- production/video-tag-decision.md - Video / OffthreadVideo / Html5Video / @remotion/media の選択
- production/input-props.md - プロパティ解決順序、Zod バリデーション、--props CLI フラグ、レンダリング境界のセキュリティ
- production/caption-timing-safety.md - キャプションの単調増加 inputRange と適応型フェードウィンドウ
- production/performance.md - ハードウェアアクセラレーション、並行処理、画像フォーマット、GPU プリコンピュート、ベンチマーク
- production/env-vars.md - REMOTION_ プレフィックス、.env 読み込み、inputProps / envVariables によるシークレット
インテグレーション
- integration/nextjs.md - Next.js App Router: Player SSR ガード、transpilePackages、Lambda 用 API ルート
- integration/docker.md - Docker: ベースイメージ、--shm-size、フォント、Chromium フラグ、CI の例
- integration/mediabunny-migration.md - 非推奨の media-parser/webcodecs から Mediabunny Video/Audio への移行
- integration/v5-prep.md - v4 コードを v5 の破壊的変更に対して将来性を持たせる
パッケージ
- packages/paths.md - @remotion/paths SVG パスユーティリティ(interpolatePath、warpPath、getLength)
- packages/shapes.md - @remotion/shapes ビルド済み SVG プリミティブ(Triangle、Circle、Star、Pie、Heart)
- packages/noise.md - @remotion/noise シード付きパーリンノイズ(noise2D、noise3D、noise4D)
- packages/motion-blur.md - @remotion/motion-blur Trail と CameraMotionBlur(控えめに使用)
- packages/skia.md - @remotion/skia 高性能キャンバス(React Native Skia)
- packages/rive.md - @remotion/rive ステートマシンによるアニメーション(Lottie の代替)