Remotion — 工具包扩展
核心 Remotion 知识位于
.claude/skills/remotion-official/目录下(从官方 remotion-dev/skills 仓库同步)。本文件仅涵盖特定工具包的模式。
共享组件
位于 lib/components/ 的可重用视频组件。在模板中通过以下方式导入:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| 组件 | 用途 |
|---|---|
AnimatedBackground | 浮动形状背景(变体:subtle、tech、warm、dark) |
SlideTransition | 场景转场(淡入淡出、缩放、上滑、模糊淡入淡出) |
Label | 浮动标签徽章,可附带 JIRA 引用 |
Vignette | 电影边缘暗化叠加层 |
LogoWatermark | 角落品牌 Logo |
SplitScreen | 并排视频比较 |
NarratorPiP | 画中画主持人叠加层 |
Envelope | 具有开盖动画的 3D 信封 |
PointingHand | 带滑入和脉冲动画的手部表情符号 |
MazeDecoration | 角落装饰用动画等距网格 |
自定义转场
该工具包包含一个位于 lib/transitions/ 的转场库,用于提供超出官方 @remotion/transitions 包功能的场景间效果。
使用 TransitionSeries
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// 从 lib 导入自定义转场(根据项目位置调整路径)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// 或者从官方包导入
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
可用的自定义转场
| 转场 | 选项 | 最佳用途 |
|---|---|---|
glitch() | intensity、slices、rgbShift | 技术演示、锐利揭示、赛博朋克 |
rgbSplit() | direction、displacement | 现代科技、充满活力的转场 |
zoomBlur() | direction、blurAmount | 号召性用语、高能时刻、冲击效果 |
lightLeak() | temperature、direction | 庆祝活动、电影美学、温馨时刻 |
clockWipe() | startAngle、direction、segments | 时间相关内容、趣味揭示 |
pixelate() | maxBlockSize、gridSize、scanlines、glitchArtifacts、randomness | 复古/游戏风格、数字化转换 |
checkerboard() | gridSize、pattern、stagger、squareAnimation | 趣味揭示、结构化转场 |
棋盘图案: sequential、random、diagonal、alternating、spiral、rows、columns、center-out、corners-in
转场示例
// 技术/赛博朋克风格
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// 温暖庆祝风格
lightLeak({ temperature: 'warm', direction: 'right' })
// 高能缩放
zoomBlur({ direction: 'in', blurAmount: 20 })
// 色差效果
rgbSplit({ direction: 'diagonal', displacement: 30 })
// 时钟扫屏揭示
clockWipe({ direction: 'clockwise', startAngle: 0 })
// 复古像素化
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// 棋盘图案
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
转场时间指南
| 类型 | 帧数 | 备注 |
|---|---|---|
| 快速剪切 | 15-20 | 快速、有力 |
| 标准 | 30-45 | 最常见 |
| 戏剧性 | 50-60 | 缓慢揭示 |
| 故障效果 | 20-30 | 应感觉突然 |
| 漏光 | 45-60 | 需要时间扫描 |
预览转场
运行展示画廊以查看所有转场:
cd showcase/transitions && npm run studio
工具包最佳实践
- 仅使用基于帧的动画 — 避免使用 CSS 过渡/动画;它们在渲染期间会导致闪烁
- 使用 useVideoConfig() 中的 fps — 使动画与帧速率无关
- 钳制插值 — 使用
extrapolateRight: 'clamp'防止值失控 - 使用 OffthreadVideo — 对于复杂合成,性能优于
<Video> - 对 async 使用 delayRender — 始终在数据准备就绪前阻止渲染
- 对资源使用 staticFile — 正确引用
public/文件夹中的文件 - 所有项目均使用 30fps — 时间换算:帧数 = 秒 × 30
- playbackRate 必须恒定 — 对于可变/极端速度,使用 FFmpeg 进行预处理
项目计时约定
| 场景类型 | 时长 | 备注 |
|---|---|---|
| 标题 | 3-5s (90-150f) | Logo + 标题 |
| 概览 | 10-20s | 3-5 个要点 |
| 演示 | 10-30s | 调整 playbackRate 以适应 |
| 数据 | 8-12s | 3-4 个数据卡片 |
| 鸣谢 | 5-10s | 快速淡出 |
节奏: 画外音约 150 字/分钟。画外音驱动时间。
高级 API
有关所有钩子、组件、渲染器、Lambda 和 Player API 的详细 API 文档,请参阅 reference.md。
许可证说明
Remotion 具有特殊许可证。公司可能需要获得商业使用许可证。请查看 https://remotion.dev/license
反馈与贡献
如果此技能缺少信息或可以改进:
- 缺少某个模式? 描述您需要的内容
- 发现错误? 告知我具体问题
- 想要贡献? 我可以帮助您:
- 更新此技能以进行改进
- 向 github.com/digitalsamba/claude-code-video-toolkit 创建 PR
只需说“改进此技能”,我将指导您更新 .claude/skills/remotion/SKILL.md。