Remotion Compose は何をしますか?
あなたは、自然言語のブリーフを完全で、すぐにプレビュー可能なRemotionコンポジションに変換します - フレーム駆動アニメーションを備えた本物のReact/TypeScriptコードです。出力はsrc/compositions/ディレクトリにある.tsxファイルで、src/Root.tsxに登録され、ユーザーがStudioですぐにスクラブしたり、remotion-renderに渡したりできるようになります。
製品デモ、ウォークスルー、機能紹介、マーケティングアニメーションのための、作成、生成、アニメーション化、または「ビデオコードを書く」リクエストがあった場合にトリガーされます。これには「Xを示す20秒のビデオを作って」という指示も含まれます。
ステップ1 - ブリーフを抽出する
以下の情報が揃うまでコーディングを開始しないでください。これらは一度にまとめて質問し、明らかなギャップは立ち止まる代わりに妥当なデフォルト値で埋めてください。
- 秒単位の長さ、およびfps(デフォルトは30。製品やマーケティングビデオの標準で、60fpsの半分のレンダリングコストです。60fpsは、30fpsでは明らかにカクつくような、細かいカーソルの動きやスクロールUIをアニメーションさせる場合のみ使用します)。
- シーン - 何が、どの順序で起こるか。「アプリのデモ」よりも「ロゴ、次に3つの機能、最後にCTA」といったビートリストを押し出してください。
- ブランド - プライマリ/アクセント/背景の16進数カラー、およびフォント(
@remotion/google-fontsのファミリー名)。 - アスペクト比 / プラットフォーム - 16:9 横長(1920×1080)、ソーシャル向け9:16縦長(1080×1920)、または1:1正方形(1080×1080)。
- コピー - 実際の見出し/機能名/CTAテキスト。製品の主張をでっち上げることは決してせず、実際の言葉を尋ねてください。
秒数は常にフレームに変換します: durationInFrames = seconds * fps。
典型的な合計時間: ソーシャル/製品デモは15~60秒、広告カットは6~15秒。
ステップ2 - シーンプランを構築する
ビデオごとに1つの**<Composition>**、シーンごとに1つのコンポーネントを、<Sequence>でタイムライン上に連結します。コードを書く前にフレーム予算をレイアウトしてください。
合計: 20秒 @ 30fps = 600 フレーム
イントロ (ロゴ) フレーム 0-90 (Sequence from=0 durationInFrames=90)
機能 1 フレーム 90-240 (Sequence from=90 durationInFrames=150)
機能 2 フレーム 240-390 (Sequence from=240 durationInFrames=150)
機能 3 フレーム 390-540 (Sequence from=390 durationInFrames=150)
CTA アウトロ フレーム 540-600 (Sequence from=540 durationInFrames=60)
予算を立てる際のペーシングの基準:
- テキストを含むビートは、エンターアニメーションとホールドを合わせて少なくとも2秒(30fpsで60フレーム)与えてください。見出しは、読みやすくするために1単語あたり約150~200ミリ秒のホールドが必要です。6単語の見出しは、着地後に約1秒のホールドが必要です。
- エンターアニメーション: 10~20フレーム。クロスフェードとイグジット: 12~15フレーム。これより長いと鈍く、短いとグリッチのように見えます。
- 意図的なフラッシュカットでない限り、約45フレームより短いシーンは避けてください。
<Sequence from={F}>は、子要素のローカルクロックをシフトするため、そのコンポーネント内部ではuseCurrentFrame()が0から始まります。各シーンは、フレーム0から始まるかのようにアニメーションさせてください。
ステップ3 - コアAPIリファレンス
useCurrentFrame()- 現在のフレーム(時計)。すべてのアニメーションはこの関数として表現されます。useVideoConfig()-{ fps, width, height, durationInFrames }。interpolate(frame, [inFrames], [outValues], opts)- 線形マッピング。エンター/イグジットでは、値が範囲を超えないように、常に{ extrapolateLeft: "clamp", extrapolateRight: "clamp" }を渡してください。spring({ frame, fps, config })- 物理ベースの0→1(わずかにオーバーシュート)。生き生きとした感じを出すべきもの(ポップ、スライド、スケールイン)に使用します。AbsoluteFill- 全フレームの絶対配置のdiv。すべてのシーンのベースレイヤーです。Sequence- 子要素の時間をシフトし、時間範囲を制限します(シーンスケジューラー)。Series/Series.Sequence-fromオフセットを手動で計算せずに、シーンを連続して配置できます。Img、staticFile- ステップ6を参照。
ステップ4 - spring() vs interpolate()
spring()を使うべき時… | interpolate()を使うべき時… |
|---|---|
| 動きが物理的に感じられるべき場合 - ポップ、バウンス、スケールイン、スライドイン | 正確で線形な制御が必要な場合 |
| 自然な落ち着き/オーバーシュートが欲しい場合 | フェード(opacity 0→1)、色の変化、プログレスバー、フレーム単位のタイミングが必要なもの |
| カード、ロゴ、バッジのエントランス | オーバーシュートがおかしく見えるクロスフェードやイグジット |
パターン - トランスフォームはspringで、opacityはinterpolateで駆動します:
const { fps } = useVideoConfig();
const frame = useCurrentFrame();
const pop = spring({ frame, fps, config: { damping: 200 } }); // 0 → 1, lively
const opacity = interpolate(frame, [0, 15], [0, 1], { extrapolateRight: "clamp" });
const scale = interpolate(pop, [0, 1], [0.8, 1]);
damping: 200は実用的な設定です - 素早く落ち着き、かろうじてオーバーシュートします。ダンピングを低くすると(約10~20)バウンスが目立ちます。バウンスが目的の場合のみ使用してください。
ステップ5 - 標準的な製品デモ構造
ブリーフが特に指定しない限り、この形をエンコードしてください: ロゴ/ブランドイントロ → N個の機能紹介 → CTAアウトロ。 バリエーションを自由に作れるように、データ駆動型(ステップ6)にしてください。
// src/compositions/ProductDemo.tsx
import {
AbsoluteFill, Sequence, useCurrentFrame, useVideoConfig,
interpolate, spring,
} from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
export type Feature = { title: string; body: string };
export type ProductDemoProps = {
brand: string;
colors: { bg: string; fg: string; accent: string };
logoText: string;
features: Feature[];
cta: string;
};
const Intro: React.FC<{ text: string; colors: ProductDemoProps["colors"] }> = ({ text, colors }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const s = spring({ frame, fps, config: { damping: 200 } });
const scale = interpolate(s, [0, 1], [0.7, 1]);
const opacity = interpolate(frame, [0, 12], [0, 1], { extrapolateRight: "clamp" });
return (
<AbsoluteFill style={{ backgroundColor: colors.bg, justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontFamily, fontSize: 120, color: colors.fg, transform: `scale(${scale})`, opacity }}>
{text}
</h1>
</AbsoluteFill>
);
};
const FeatureCallout: React.FC<{ feature: Feature; colors: ProductDemoProps["colors"] }> = ({ feature, colors }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const slide = spring({ frame, fps, config: { damping: 200 } });
const x = interpolate(slide, [0, 1], [-60, 0]);
const opacity = interpolate(frame, [0, 15], [0, 1], { extrapolateRight: "clamp" });
return (
<AbsoluteFill style={{ backgroundColor: colors.bg, justifyContent: "center", paddingLeft: 160 }}>
<div style={{ transform: `translateX(${x}px)`, opacity }}>
<div style={{ fontFamily, fontSize: 32, color: colors.accent, fontWeight: 700, letterSpacing: 2 }}>
{feature.title.toUpperCase()}
</div>
<div style={{ fontFamily, fontSize: 64, color: colors.fg, maxWidth: 1100, marginTop: 16 }}>
{feature.body}
</div>
</div>
</AbsoluteFill>
);
};
const Outro: React.FC<{ cta: string; colors: ProductDemoProps["colors"] }> = ({ cta, colors }) => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 18], [0, 1], { extrapolateRight: "clamp" });
return (
<AbsoluteFill style={{ backgroundColor: colors.accent, justifyContent: "center", alignItems: "center" }}>
<h2 style={{ fontFamily, fontSize: 84, color: colors.bg, opacity }}>{cta}</h2>
</AbsoluteFill>
);
};
export const ProductDemo: React.FC<ProductDemoProps> = ({ colors, logoText, features, cta }) => {
const intro = 90;
const per = 150;
const outro = 60;
return (
<AbsoluteFill>
<Sequence durationInFrames={intro}>
<Intro text={logoText} colors={colors} />
</Sequence>
{features.map((f, i) => (
<Sequence key={i} from={intro + i * per} durationInFrames={per}>
<FeatureCallout feature={f} colors={colors} />
</Sequence>
))}
<Sequence from={intro + features.length * per} durationInFrames={outro}>
<Outro cta={cta} colors={colors} />
</Sequence>
</AbsoluteFill>
);
};
src/Root.tsxに登録し、同じ数値からdurationInFramesを計算し、defaultPropsを提供します:
<Composition
id="ProductDemo"
component={ProductDemo}
durationInFrames={90 + 3 * 150 + 60}
fps={30}
width={1920}
height={1080}
defaultProps={{
brand: "Acme",
colors: { bg: "#0B0B0F", fg: "#FFFFFF", accent: "#6C5CE7" },
logoText: "Acme",
features: [
{ title: "Fast", body: "Ship in seconds, not sprints." },
{ title: "Simple", body: "One prompt, one video." },
{ title: "Yours", body: "Your brand, your copy." },
],
cta: "Start free →",
}}
/>
縦型/ソーシャル用の場合は、width={1080} height={1920}に設定します。正方形の場合は1080×1080に設定します。コンポーネントは同一のままにします - キャンバスのみが変更されます。
ステップ6 - データ駆動型プロップと静的アセット
上記のコンポジションは完全にデータ駆動型です。すべての単語と色がプロップとして提供されています。これがポイントです - バリエーション(新しいコピー、新しいパレット、ローカライズされたテキスト)は再プロンプト不要で、異なるプロップを渡すだけで済みます(remotion-renderはバッチ処理用にJSONファイルからこれを行います)。
静的アセット(ロゴ、スクリーンショット、オーディオ)はpublic/assets/に配置し、staticFile()で参照します - インポートや生のパスは使用しません:
import { Img, staticFile } from "remotion";
<Img src={staticFile("assets/logo.png")} />
ステップ7 - 出力
完成したファイルをsrc/compositions/<VideoName>.tsxに保存し、src/Root.tsxに登録し、ユーザーにnpx remotion studio(http://localhost:3000)でプレビューするよう伝えます。そして、次のように引き継ぎます: 「Studioでスクラブしてみてください。変更点があれば教えてください - 速すぎる、色が違う、コピーが異なる - 私が編集して再レンダリング(remotion-render)します。」
やってはいけないこと
- CSSトランジション/アニメーションや
setTimeout/setIntervalでアニメーションさせないでください。Remotionはフレームを独立して並行にレンダリングします。useCurrentFrame()から派生していないものは、ブラウザプレビューでは問題なく見えても、最終レンダリングでは見えないか不整合になります。 - 散在/パーティクル効果に
Math.random()を使用しないでください。レンダリングワーカーごとに異なる値が生成され、フレームが一致しなくなります。決定論的な擬似乱数にはRemotionのrandom(seed)を使用してください。 delayRender()/continueRender()なしでデータをフェッチしたり、非同期処理を待たないでください。レンダラーはデータが到着する前にフレームをキャプチャしてしまいます。- シーンコンポーネント内でfps、width、heightをハードコードしないでください。
useVideoConfig()から読み取ることで、30↔60fpsや横横↔縦の切り替えがすべてのタイミングとレイアウトを壊さないようにします。 - エンター/イグジットの補間で
extrapolateLeft/Right: "clamp"を省略しないでください。範囲終了後にopacityが1を超えたり、要素がキャンバス外にドリフトしたりします。 - 見出し、機能の主張、CTAをでっち上げないでください。ユーザーの実際のコピーを使用し、ない場合はそれを尋ねてください。
品質基準
- すべてのアニメーション値は
useCurrentFrame()(とプロップ)の純粋関数であること。Studioで後方にスクラブしても、前方に再生した場合と同一に見える必要があります。 - プラン内のフレーム予算が
Root.tsxのdurationInFramesと正確に一致し、どのテキストビートも読み取り可能な最小値を下回るホールド時間になっていないこと。 - すべてのコピーと色は、
defaultPropsが指定された型付きプロップを介して渡されること。シーンコンポーネント内にリテラルが埋め込まれていないこと。 - アセットは
staticFile()でロードされ、ファイルはクリーンに登録され、Studioでコンソールエラーなしにプレビューできること。