SuperAPI AI 工具集

remotion-video

设计与创作

查看项目

更新于 10-26 16:17

技能介绍

Remotion Video 是一个面向程序化视频创作的技能,基于 Remotion 框架。Remotion 允许用 React 组件编写视频:每一帧都是当前帧号的函数,而不是依赖时间线编辑器,因此可以充分使用 TypeScript、npm 包和组件化架构来构建视频,例如动画讲解、社交媒体短片、数据驱动可视化和规模化个性化视频。

用途与触发场景:当用户希望用 React/TypeScript 以编程方式创建视频,询问 Remotion 合成、useCurrentFrame 或 useVideoConfig,需要对文字、元素或场景转场做动画,希望从代码渲染 MP4、WebM 或 GIF,询问 spring 动画、interpolate 或基于帧的计时,需要从零搭建 Remotion 项目,添加音频、图片或字体,进行参数化/数据驱动视频生成,或配置 Remotion Studio 预览合成时,可使用本技能。不适用于与视频无关的普通 React 问题、传统时间线工具剪辑(Premiere、DaVinci、FFmpeg CLI)、网页 CSS 动画或 Web 应用中的视频播放与流媒体。

核心原则:每一帧都是纯函数,组件通过 useCurrentFrame() 获取当前帧,必须确定性地渲染该帧,不使用无种子随机数、不依赖实际时钟,同一帧号始终产生相同视觉输出。合成是视频的基本单位,每个 <Composition> 明确定义宽高、帧率(fps)和时长(durationInFrames),可按视频变体或场景独立渲染。interpolate() 将帧号映射到任意数值(透明度、位置、缩放、颜色通道),配合 extrapolateRight: 'clamp' 是动画的主力;需要物理感缓动时使用 spring()。用 <Sequence from={frame}> 延迟子元素出现,用 <Series> 依次播放子元素,不要使用 setTimeout 或手动帧计算做编排。素材放在 public/ 目录并通过 staticFile() 引用;动态数据(API 响应、数据库记录)使用 delayRender()/continueRender() 暂停渲染直到加载完成。

主要能力与常见任务:使用 npx create-video@latest 搭建带 TypeScript、示例合成和 Remotion Studio 的项目,用 npx remotion studio 启动预览。创建基于 useCurrentFrame 的基础合成,实现淡入与位移;按词拆分文本并用 Sequence 错开每个词的出现;用 spring() 实现元素弹入和上滑;用 Sequence 与 Series 实现多场景切换。通过 staticFile() 引用 public/ 中的图片,用 @remotion/google-fonts 或 CSS @font-face 加载字体。使用 Audio 组件配合 volume 函数和 Sequence 添加背景音乐与音效。使用命令行渲染视频,如 npx remotion render src/index.ts MyVideo out/video.mp4,可通过 --width/--height 指定 4K、--codec vp8 输出 WebM、--frames 指定帧范围、--props 传入自定义参数;编程式渲染参考 references/rendering-guide.md。

参考资料:技能附带 references/animation-patterns.md(错峰级联、视差、形变转场、缓动曲线等高级动画)、references/rendering-guide.md(渲染配置、编码选项、Lambda/云渲染、编程渲染 API、GIF 输出与性能优化)、references/project-structure.md(项目组织、Zod 参数化视频、可复用组件、共享样式与多合成架构)。仅在任务需要时加载,因为文件较长会占用上下文。

常见错误与注意事项:避免无种子 Math.random(),改用确定性种子或 Remotion 的 random();不用 setTimeout/setInterval,统一用 useCurrentFrame() 和帧计算;interpolate 务必加 { extrapolateRight: 'clamp' },否则数值会超出目标范围;不要硬编码 fps,改用 useVideoConfig().fps;渲染输出优先用 <OffthreadVideo> 而非 <Video> 以提升性能;异步数据要调用 delayRender()/continueRender(),否则会渲染空帧;样式值必须仅由帧号推导,避免闪烁或不一致;避免单一巨型合成,拆分为多个合成或用 Series 组织场景。

细节陷阱:extrapolateRight 默认是 'extend',不加 clamp 时数值会在目标帧后继续增长;spring() 在 <Sequence from={60}> 内从该序列的帧 0 开始,子组件内应使用 useCurrentFrame() 而非父级原始帧;staticFile() 路径相对于 public/,使用绝对路径或 public/ 之外路径会在预览中静默失败、渲染时报错;delayRender 默认 30 秒超时,慢操作可通过 { timeoutInMilliseconds: 60000 } 延长;视频编码要求宽高为偶数,奇数尺寸(如 1921x1081)会报错。

配套检查:首次在对话中激活该技能时,运行 ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null 检查已安装的配套技能,与 frontmatter 中的 recommended_skills 比对;对缺失项提示一次并提供安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。若 recommended_skills 为空或全部已安装则跳过。

限制:资料未提供该技能的收费、价格、平台支持范围与具体效果数据,暂未提供。