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 | 角落標誌品牌 |
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
如需所有鉤子、元件、渲染器、Lambda 及 Player API 的詳細 API 文件,請參閱 reference.md。
授權說明
Remotion 具有特殊授權。公司可能需要取得授權才能用於商業用途。請查看 https://remotion.dev/license
意見回饋與貢獻
如果此技能缺少資訊或可改進:
- 缺少某個模式? 請描述您需要的內容
- 發現錯誤? 請告知問題所在
- 想貢獻? 我可以協助您:
- 使用改進內容更新此技能
- 建立 PR 到 github.com/digitalsamba/claude-code-video-toolkit
只需說「改進此技能」,我將引導您更新 .claude/skills/remotion/SKILL.md。