使用時機
在以下情況使用此技能:
- 從程式碼建立程式化影片(非生成式 AI 影片)
- 製作資料驅動的影片內容(圖表、統計、個人化影片)
- 從模板加資料批次產出影片
- 製作動態社群媒體內容(TikTok、Reels、Shorts)
- 需要精準控制來製作產品介紹或解說影片
快速開始
1. 建立新專案
python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video
2. 撰寫你的 Composition
編輯 src/Composition.tsx —— 這是以 React 元件定義的影片。
3. 在 Studio 中預覽
python3 Skills/remotion/scripts/remotion_cli.py studio my-video
4. 渲染為 MP4
python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4
核心概念
Compositions
Composition 定義了影片的尺寸、長度與 FPS:
<Composition
id="MyVideo"
component={MyComponent}
durationInFrames={300} // 30fps 下為 10 秒
fps={30}
width={1920}
height={1080}
/>
基於幀的動畫
所有動畫必須使用 useCurrentFrame(),禁止使用 CSS 動畫。
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
Sequences
使用 <Sequence> 控制元素出現的時間:
<Sequence from={30} durationInFrames={60}>
<Title />
</Sequence>
規則參考文件
從上游 Remotion 技能載入的詳細模式,請閱讀下列文件:
| 規則 | 說明 |
|---|---|
references/animations.md | 基於幀的動畫基礎 |
references/timing.md | Spring、緩動、插值曲線 |
references/compositions.md | 定義 Composition、靜態圖片、資料夾 |
references/sequencing.md | 元素時間與順序 |
references/videos.md | 嵌入影片 - 裁剪、音量、速度 |
references/audio.md | 音訊處理 - 匯入、裁剪、音量 |
references/assets.md | 圖片、字型、靜態檔案 |
references/transitions.md | 場景轉場效果 |
references/text-animations.md | 字體動畫模式 |
references/charts.md | 資料視覺化模式 |
references/display-captions.md | TikTok 風格字幕 |
CLI 指令
# 專案管理
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output path]
python3 Skills/remotion/scripts/remotion_cli.py list
# 渲染選項
--composition ID # 指定要渲染的 Composition(預設為第一個)
--output PATH # 輸出檔案路徑(預設為 out/video.mp4)
--fps N # 覆寫 FPS
--width N # 覆寫寬度
--height N # 覆寫高度
--codec CODEC # h264, h265, vp8, vp9, prores(預設為 h264)
常見模式
淡入/淡出
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
Spring 動畫(自然運動)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // 平滑,無彈跳
});
錯開的元素
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
資料驅動影片
type VideoProps = { title: string; stats: number[] };
export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
// 根據 props 製作動畫
};
// 在 Root.tsx 中:
<Composition
id="DataVideo"
component={DataVideo}
defaultProps={{ title: "Q4 結果", stats: [10, 20, 30] }}
// ...
/>
與 Zo 整合
批次渲染
使用 /zo/ask 以平行方式渲染多個影片:
for row in data:
# 每次呼叫使用不同的 props 渲染
await render_video(row)
輸出位置
為了與 Zo 的站點系統一致,專案放置於 Sites/<name>/。
渲染完成的影片會輸出到 Sites/<name>/out/。
限制
- 禁止 CSS 動畫 —— 它們無法正確渲染
- 禁止 Tailwind 動畫 class —— 同樣問題
- 僅限基於幀的動畫 —— 所有移動都來自
useCurrentFrame() - CPU 密集 —— 渲染需要時間;複雜影片 = 更長的渲染時間
- 需要 Node.js —— Remotion 需要 Node 環境(Zo 中已提供)