Remotion Compose 是做什么的?
你将一份自然语言简报变成完整的、可即时预览的 Remotion 合成——真实的 React/TypeScript,带有帧驱动的动画。输出是 src/compositions/ 中的一个 .tsx 文件,注册在 src/Root.tsx 中,用户可以在 Studio 中立即预览,或交给 remotion-render。
当任何请求涉及创建、生成、动画化或“为产品演示、导览、功能展示或营销动画编写视频代码”时触发——包括“制作一个 20 秒的展示 X 的视频”。
第一步 - 提取简报
在获得这些信息之前不要开始编码。将它们打包成一个紧凑的批次询问;用合理的默认值填补明显的空白,而不是停滞不前:
- 时长(秒)和 fps(默认 30 - 产品和营销视频的标准,渲染成本是 60fps 的一半。仅在动画精细光标运动或滚动 UI(30fps 明显卡顿)时才使用 60fps)。
- 场景 - 按顺序发生的事情。推动生成一个节奏列表:“Logo,然后三个功能,最后 CTA”优于“我的应用演示”。
- 品牌 - 主色/强调色/背景色的 hex 值,以及字体(一个
@remotion/google-fonts的字体族名称)。 - 宽高比 / 平台 - 16:9 横屏(1920×1080)、9:16 竖屏(1080×1920)用于社交平台,或 1:1 正方形(1080×1080)。
- 文案 - 实际的标题/功能名称/CTA 文本。切勿编造产品声明;询问真实文案。
在所有地方将秒转换为帧:durationInFrames = seconds * fps。典型总长度:社交/产品演示 15-60 秒,广告短片 6-15 秒。
第二步 - 构建场景计划
每个视频一个 <Composition>,每个场景一个组件,在时间线上用 <Sequence> 拼接。在编写代码之前规划好帧预算:
总计:20s @ 30fps = 600 帧
开场(Logo) 帧 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 帧)——入场动画加停留。一个标题每个字大约需要 150-200ms 的停留才能被阅读;一个 6 个字的标题在“落地后”需要大约 1 秒的停留。
- 入场动画:10-20 帧。淡入淡出和退出:12-15 帧。再长显得拖沓,再短像故障。
- 除非是故意的闪切,否则场景不要短于约 45 帧。
<Sequence from={F}> 会移动子组件的本地时钟,因此该组件内的 useCurrentFrame() 从 0 开始。将每个场景动画视为从第 0 帧开始。
第三步 - 核心 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- 见第六步。
第四步 - spring() vs interpolate()
使用 spring() 当…… | 使用 interpolate() 当…… |
|---|---|
| 运动应该感觉有物理感——弹出、反弹、缩放进入、滑动进入 | 需要在精确帧之间进行精确的线性控制 |
| 你想要自然的稳定/过冲效果 | 淡入淡出(透明度 0→1)、颜色变化、进度条,以及任何需要按帧计时的内容 |
| 卡片、Logo、徽章的入场 | 淡入淡出和退出,过冲效果会看起来不对劲 |
模式——用 spring 驱动变换,用 interpolate 驱动透明度:
const { fps } = useVideoConfig();
const frame = useCurrentFrame();
const pop = spring({ frame, fps, config: { damping: 200 } }); // 0 → 1, 活泼
const opacity = interpolate(frame, [0, 15], [0, 1], { extrapolateRight: "clamp" });
const scale = interpolate(pop, [0, 1], [0.8, 1]);
damping: 200 是万能配置——快速稳定,几乎察觉不到过冲。较低的阻尼(~10-20)会明显反弹;仅在需要反弹效果时使用。
第五步 - 标准产品演示结构
除非简报另有说明,否则采用这种结构:Logo/品牌介绍 → N 个功能展示 → CTA 结尾。 使其数据驱动(第六步),以便变体无需额外提示。
// 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。保持组件相同——只有画布改变。
第六步 - 数据驱动的 props 与静态资源
上面的组合是完全数据驱动的:每个词和颜色都是一个 prop。这就是关键所在——变体(新文案、新调色板、本地化文本)无需重新提示;只需传递不同的 props(remotion-render 通过 JSON 文件批量处理)。
静态资源(Logo、截图、音频)存放在 public/assets/ 中,并通过 staticFile() 引用——不要使用 import 或原始路径:
import { Img, staticFile } from "remotion";
<Img src={staticFile("assets/logo.png")} />
第七步 - 输出
将完成的文件保存到 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"——透明度会超过 1,元素在范围结束后会漂移到画布之外。 - 不要编造标题、功能声明或 CTA——使用用户的真实文案,如果缺少则询问。
质量标准
- 每个动画值都是
useCurrentFrame()(加上 props)的纯函数——在 Studio 中向后预览与向前播放看起来一样。 - 计划中的帧预算总和恰好等于
Root.tsx中的durationInFrames,并且没有文本段落的停留时间低于其可读最小值。 - 所有文案和颜色都通过类型化的 props 传递,并提供了
defaultProps——没有字面量隐藏在场景组件中。 - 资源通过
staticFile()加载;文件注册干净,在 Studio 中预览时没有控制台错误。