Remotion — 工具包扩展
核心 Remotion 知识 位于
.claude/skills/remotion-official/(从官方 remotion-dev/skills 仓库同步而来)。本文档仅涵盖工具包特有的模式。
共享组件
位于 lib/components/ 中的可复用视频组件。在模板中通过以下方式导入:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| 组件 | 用途 |
|---|---|
AnimatedBackground | 浮动形状背景(变体:subtle, tech, warm, dark) |
SlideTransition | 场景转场(fade, zoom, slide-up, blur-fade) |
Label | 浮动标签徽章,可选带 JIRA 引用 |
Vignette | 电影感边缘暗化叠加 |
LogoWatermark | 角落 logo 品牌标记 |
SplitScreen | 并排视频对比 |
NarratorPiP | 画中画演示者叠加 |
Envelope | 带开盖动画的 3D 信封 |
PointingHand | 带滑入和脉冲动画的手指 emoji |
MazeDecoration | 用于角落的动画等距网格装饰 |
自定义转场
工具包包含位于 lib/transitions/ 的转场库,用于提供超越官方 @remotion/transitions 包的场景间效果。
使用 TransitionSeries
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// 从 lib 导入自定义转场(根据项目位置调整路径)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// 或从 @remotion/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> - 异步操作使用 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 的详细文档,请参阅 reference.md。
许可证说明
Remotion 拥有特殊许可证。公司可能需要获取商业使用许可证。请查看 https://remotion.dev/license
反馈与贡献
如果此技能缺少信息或可以改进:
- 缺少某个模式? 描述您需要的内容
- 发现错误? 告诉我哪里有问题
- 想要贡献? 我可以帮助您:
- 通过改进更新此技能
- 向 github.com/digitalsamba/claude-code-video-toolkit 创建 PR
只需说“改进此技能”,我将指导您更新 .claude/skills/remotion/SKILL.md。