Remotion 视频构建器
您的 Remotion 知识可能已经过时。当需要确切的 API 行为时,请优先使用官方的 remotion-documentation MCP 服务器或 remotion.dev 上的文档。
从这里开始
- 如果项目尚不存在,请使用
npx create-video@latest搭建,并优先选用空白模板。 - 确保所有
remotion和@remotion/*包的版本完全相同,避免使用 caret 范围。 - 标准的入口结构:
src/index.ts调用registerRoot()src/Root.tsx使用<Composition>或<Still>注册所有视频
构建顺序
- 首先建模输入契约:
- 顶层 props schema
- 时间线或事件数据
- 渲染配置文件
- 使用
zod定义共享 props,并将 schema 传递给每个<Composition>。 - 使用
calculateMetadata派生durationInFrames、width、height、转换后的 props 以及defaultOutName。 - 使用
<Series>构建叙事顺序的场景结构,使用<Sequence>构建覆盖层、进场、素材窗口和标注。 - 在 Remotion v4.x 项目中,对于需要在其出现前加载资源的
<Sequence>元素,显式设置premountFor。 - 在打磨动画之前添加示例数据和渲染脚本。
默认值与规则
- 除非另有说明,默认
fps={30},横屏为1920x1080。 - 使用
AbsoluteFill进行分层。 - 使用
staticFile()处理来自public/的内容。 - 使用
useCurrentFrame()和useVideoConfig()实现基于帧的逻辑。 - 优先选择微妙的动效:
- 高阻尼的
spring() - 带夹紧的
interpolate()
- 高阻尼的
- 不要使用
Math.random()。请使用remotion中的random(seed)。 - 保持文本动画简单且清晰易读。
- 除非需求确实要求不同,否则保持横屏和竖屏输出使用相同的业务逻辑。
参数化视频清单
- 一个共享的顶层
z.object()schema - 与组件 prop 形状匹配的
defaultProps - 当输入需要时,
calculateMetadata返回动态的持续时间或尺寸 - 用于本地预览的示例 JSON 或 TypeScript 数据
- 每个目标输出的渲染脚本
素材策略
当素材为可选时,至少支持以下模式:
noneplaceholderreal
即使没有真实素材,时间线和覆盖层也应正常渲染。
Millrace 启动视频
如果请求涉及 Millrace 或启动视频管道,请在实施之前阅读 references/millrace-launch-video.md。