コード生成とレンダリング
あなたはブリーフをplan.jsonに変換し、それをレンダリングします。参照プロジェクトはすでにローンチビデオの文法を実装しており、あなたはそれにデータを渡すだけで、ビデオをゼロから書くわけではありません。
参照プロジェクトの洗練度は、このツールが生成するすべてのビデオの洗練度です。 したがって、強力なデフォルトは次のとおりです。plan.jsonを書き、他は変更しないこと。個々の実行に追加するアニメーションの1行1行は、次のビデオには決して届かないポリッシュであり、レンダリングを壊す新しい方法です。
ファイルマップ
pitchframe/
├── plan.json ← シーンプラン。これがビデオです。
├── palette.json ← 抽出された色。データであり、散文ではありません。
├── public/assets/*.png ← キャプチャされたスクリーンショット。
├── scripts/
│ ├── extract-palette.mjs ← tailwind → CSS vars → ライブURL
│ ├── apply-palette.mjs ← palette.jsonからsrc/theme.tsを書き込み
│ └── capture.mjs ← 開発サーバー + Playwrightキャプチャ
├── src/
│ ├── Root.tsx ← LaunchVideoコンポジションを登録
│ ├── LaunchVideo.tsx ← ビートをSequencesにマッピング。クロスディゾルブを所有。
│ ├── theme.ts ← 生成済み。すべての色がここで解決されます。
│ ├── lib/
│ │ ├── types.ts ← プランのコントラクト
│ │ └── motion.ts ← イージング、フェード、クリックパルス、ホールドドリフト
│ ├── components/ ← Background, Cursor, FocusOverlay, Zoom, Panel, …
│ └── scenes/
│ ├── TypographyBeat.tsx
│ ├── InteractionBeat.tsx ← ヒーローモーメント
│ ├── UIBeat.tsx
│ └── CTABeat.tsx
└── output.mp4
プランの作成
構造とスキーマについてはpitchframe-launch-videoをロードしてください。簡略版:
- 4つのパート — セットアップ、ヒーロー、ペイオフ、CTA。この順序で。常に。
- 正確に1つの
interactionビート、そしてそれは少なくともフレームの30% を占めます。 - 時間はデフォルトではなく、ブリーフ内の
thesis_weightから取得します。 video_thesisとhero_momentをプランにコピーして、批評パスが動画を主張に対してチェックできるようにします。
レンダリング前に計算を正しく行う
レンダリングの失敗は2分のコストがかかります。ビートがずれたプランは、再レンダリングに加えて、それに気づくまでの時間がかかります。毎回手動で確認してください:
- ビートは連続している — 各
frames[0]は前のframes[1]と等しい。 - 最初のビートは0から始まり、最後のビートは正確に
total_framesで終わる。 total_frames === duration_seconds * fps。- タイポグラフィビートは45フレーム未満なし。
- インタラクションビートは
total_framesの30%以上。
座標を推測せず、理由を考えて決める
target_element.coordinatesとzoom_targetはスクリーンショットのパーセンテージです。これらは興味深いピクセルがどこにあるかという主張であり、焦点が10%ずれるとヒーローショットが空のクロームに集中してしまいます。
スクリーンショットを開き、要素を見つけ、パーセンテージに変換し、結果がビートが表示しようとしているものと一致するか確認してください。アクションの結果がターゲット以外の場所で発生する場合(ドラッグの目的地、更新されるフィールドなど)、zoom_targetをカーソルが触れたものではなく、結果 に向けてください。
色:プランにもコンポーネントにも決して入れない
theme.tsはapply-palette.mjsによってpalette.jsonから生成されます。色が書き込まれるのはここだけです。
node pitchframe/scripts/extract-palette.mjs # → palette.json
node pitchframe/scripts/apply-palette.mjs # → src/theme.ts
これに従うルール:
plan.jsonに色を決して入れないでください。 プランはどの単語が強調されるかを示し、テーマは強調色が何かを示します。- コンポーネントにカラーリテラルを決して入れないでください。 テーマが公開していない色合いが必要な場合は、ジェネレーターに派生トークンを追加して、将来のすべてのビデオでもそれを取得できるようにします。
theme.tsを手動で編集しないでください。 次回の生成で上書きされます。
2つの製品のビデオが同じように色づけされているように見える場合、theme.tsが再生成されていません。それが他の何かに触れる前に最初に確認すべきことです。
レンダリング
cd pitchframe && npx remotion render LaunchVideo output.mp4
3つのチェックを事前に行うことで、1秒のコストで2分のレンダリング失敗を防げます:
plan.jsonがパースできること。上記の計算が成立すること。- プランで指定されたすべてのスクリーンショットが
public/assets/に存在すること。インタラクションビートには**before_screenshotとafter_screenshotの両方**が必要です。 node_modulesがpitchframe/に存在すること。存在しない場合は、そこで最初にnpm installを実行します。
20秒のビデオで20〜60秒を見込んでください。
レンダリングが失敗した場合
何かを変更する前に実際のエラーを読んでください。
| 症状 | 原因 | 修正 |
|---|---|---|
Cannot find module '../plan.json' | スキャフォールドが不完全 | npx pitchframe install を再実行 |
Cannot find name 'ACCENT' 等 | theme.tsが生成されていない | apply-palette.mjs を実行 |
| フォントの遅延レンダリングタイムアウト | オフライン、またはGoogle Fontsにないフォント | palette.jsonでfonts.sansをInterに設定し再生成 |
| 画像デコードエラー | スクリーンショットが壊れているか不完全 | そのショットを再キャプチャ |
| コンポジション時間の不一致 | total_framesがビートと一致しない | 計算を修正 |
| OOM / Chromeクラッシュ | 巨大なスクリーンショット | 幅約4000px以上のものをダウンスケール。--concurrency=2 |
レンダリングの失敗に対して、コンポジションを書き換えて対応しないでください。データを修正してください。
レンダリングが2回失敗したら、停止して証拠を保持してください。 plan.json、palette.json、およびアセットをそのままにして、どのファイルを確認すべきかを示してください。調査可能なプランがある失敗したレンダリングは復旧可能ですが、書き換えで「修正」されたものは復旧できません。
コンポーネントに触れなければならない場合
ビートコンポーネントが本当に表現できないプランが必要な場合のみ。そこにたどり着いた場合の3つのルール:
- 追加し、書き換えないこと。 新しいカメラ移動は、
lib/camera.tsのSHOTSへのエントリであり、再構築されたコンポーネントではありません。そして、それはpitchframe-motion-languageにリストされている必要があります。そうでなければ、誰もそれを選択しません。 lib/motion.tsとlib/camera.tsを使用すること。EASE、EASE_OUT、clickPulse、heldDrift、entranceBlurがジャンルです。手動のイージングは、1つのビートが別のビデオから来たように見える原因です。スプリング、バウンス、エラスティックカーブは禁止です。 カメラシステムは正確に1つです。Stage.tsxの外にperspectiveや3D変換を追加しないでください。このリポジトリには以前2つあり、それらはずれ、ショットは同じ人物によって撮影されたように見えなくなりました。- データ駆動を維持すること。 追加するものはすべて、
plan.jsonのフィールドから到達可能でなければなりません。それをトリガーする唯一の方法がコンポーネントの編集である場合、それは一回限りのものであり、参照に属しません。
ここで常に間違っていること:カラーリテラル。製品名やコピーをコンポーネントにハードコードすること。新しいトップレベルコンポジション。1920×1080 / 30fpsのコントラクトを変更すること。アニメーションライブラリをインポートすること。
新しいビートタイプを追加することは、ほとんどの場合間違った答えです。 スキーマには4つしかありません。なぜなら、ローンチビデオには4つ必要だからです。新しいビートタイプは通常、変装した機能ビートであり、スキーマが機能リストを表現できるようになると、プランはそれらを含み始めます。
レンダリング成功後
パスと編集手段を報告してください:
Done. Video ready at ./pitchframe/output.mp4
To edit, just ask:
"hold the hero moment longer"
"zoom on the field that changed instead"
編集はpitchframe-editingによって処理され、パイプラインを再実行するのではありません。