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 | 角落徽标品牌标识 |
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';
// 或者从 @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-5 秒(90-150 帧) | 标志 + 标题 |
| 概述 | 10-20 秒 | 3-5 个要点 |
| 演示 | 10-30 秒 | 调整 playbackRate 以适应 |
| 统计数据 | 8-12 秒 | 3-4 个统计卡片 |
| 致谢 | 5-10 秒 | 快速淡出 |
节奏: 配音大约 150 字/分钟。配音驱动时间。
高级 API
有关所有 Hooks、组件、渲染器、Lambda 和 Player API 的详细文档,请参阅 reference.md。
许可说明
Remotion 具有特殊许可。公司可能需要获得商业使用许可。请查阅 https://remotion.dev/license
反馈与贡献
如果此技能缺少信息或可以改进:
- 缺少某个模式? 描述您需要的内容
- 发现错误? 告诉我哪里有问题
- 想要贡献? 我可以帮助您:
- 用改进更新此技能
- 向 github.com/digitalsamba/claude-code-video-toolkit 创建 PR
只需说“improve this skill”,我将指导您更新 .claude/skills/remotion/SKILL.md。