何时使用
在您编写或阅读 Remotion 代码时,从项目脚手架搭建到最终视频渲染的整个过程中,加载此技能。
常见 AI 错误(需避免)
在提交之前,请对照这些反复出现的失败模式检查每一项 Remotion 代码更改:
- 非确定性随机数 —— 使用
remotion的random(seed),绝对不要使用Math.random()、Date.now()或new Date()。否则并行渲染会导致闪烁噪声。 - 未 memoised 的
<Player>inputProps—— 始终传递 memoised 的 props;未 memoised 的 props 会导致整个组件树发生重新渲染风暴。 - 异步操作(fetch、字体加载、测量)缺少
delayRender()/continueRender()。缺少它们会导致渲染在 30,000 毫秒时挂起。 - 字幕的
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
可选:单帧渲染检查
您可以使用 CLI 渲染单帧以快速检查布局、颜色或时序。对于微不足道的编辑、纯重构图,或者当您已经从 Studio 或之前的渲染中获得足够信心时,可以跳过此步骤。
npx remotion still [composition-id] --scale=0.25 --frame=30
在 30 fps 下,--frame=30 表示一秒标记(--frame 从零开始计数)。
规则索引
阅读各个规则文件以获取详细说明和代码示例。
核心
- core/compositions.md - 定义合成、静态图片、文件夹、默认 props 和动态元数据
- core/sequencing.md - 排序模式 - 延迟、修剪、限制项目时长
- core/timing.md - 使用 interpolate、贝塞尔缓动和 spring 进行时序控制
- core/animations.md - 基础动画技能
- core/trimming.md - 修剪动画的开头或结尾
- core/parameters.md - 使用 Zod schema 使视频可参数化
- core/calculate-metadata.md - 动态设置合成时长、尺寸和 props
- 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 配置设置器(codec、CRF、concurrency、Webpack)
- production/lambda.md - AWS Lambda:deployFunction、deploySite、renderMediaOnLambda、成本调优
- production/player.md - @remotion/player 嵌入、PlayerRef、memoised inputProps、缓冲区事件
- production/video-tag-decision.md - 在 Video / OffthreadVideo / Html5Video / @remotion/media 之间进行选择
- production/input-props.md - Prop 解析顺序、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 种子化 Perlin 噪声(noise2D、noise3D、noise4D)
- packages/motion-blur.md - @remotion/motion-blur Trail 和 CameraMotionBlur(谨慎使用)
- packages/skia.md - @remotion/skia 高性能 Canvas(React Native Skia)
- packages/rive.md - @remotion/rive 状态机动画(Lottie 替代方案)