Remotion Controls Skill
用程式碼驅動影片動畫的專業控制技能。Remotion 是一個基於 React 的影片創作框架,用程式碼精確控制每一幀,原生支援透明背景渲染。
核心能力
| 能力 | 說明 |
|---|---|
| 透明背景渲染 | 原生支援 Alpha 通道,輸出 WebM(VP9) / MOV(ProRes 4444) 帶透明影片 |
| 程式碼精確控制 | 用 React/TypeScript 精確控制位置、縮放、旋轉、透明度、緩動曲線 |
| API 服務化 | HTTP API 接收動畫指令,輸出影片檔案 |
| 模板庫 | 預設動畫模板(角色動畫、UI 動畫、文字動畫、轉場特效) |
| 品質控制 | 幀率、解析度、碼率、Alpha 通道完整性自動檢測 |
| 自學習進化 | 記錄渲染參數與效果評分,最佳化預設參數 |
與 ComfyUI / Blender 的定位差異
| 技能 | 核心優勢 | 適用場景 |
|---|---|---|
| ComfyUI-controls | AI 生成(圖/影片/音訊),創意不可控 | 角色圖/場景圖/特效影片生成 |
| Blender-controls | 3D 動畫,物理模擬,高品質渲染 | 3D 角色動畫、產品展示、物理特效 |
| Remotion-controls | 2D 程式碼動畫,精確可控,透明背景 | 模板動畫素材、UI 動畫、文字排版、2D 角色動畫 |
快速開始
1. 安裝依賴
cd remotion-project
npm install
2. 渲染透明背景影片
# CLI 方式
npx remotion render src/index.ts MyComp out/video.webm --transparent
# API 方式
python remotion_controls.py render --composition MyComp --output out/video.webm --transparent
3. 啟動 API 服務
python remotion_controls.py serve --port 8765
透明背景渲染說明(已驗證流程)
Remotion 原生支援透明背景,但 CLI 的 --transparent 編碼會遺失 Alpha 通道(WebM VP8/VP9、MOV ProRes 均驗證失敗)。
已驗證的正確流程(PIT-024):
- PNG 序列渲染:
npx remotion render src/index.ts Composition out/frames --sequence(輸出帶 Alpha 的 PNG 序列) - ffmpeg 合成 ProRes 4444:
ffmpeg -y -framerate 30 -i out/frames/%04d.png \ -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \ out/animation.mov - 驗證 Alpha 通道:
python verify_animation.py out/animation.mov
剪映整合注意事項(PIT-024):
add_media_safe匯入 ProRes 4444 mov 時會自動轉碼為 H.264 mp4,遺失 Alpha(66MB→0.07MB)- 必須手動匯入:直接複製 mov 到草稿 materials 目錄 → 建立 VideoMaterial → 註冊到 materials.videos → VideoSegment(material=anim_material) → add_segment
動畫素材品質標準
完整標準請見 QUALITY_STANDARD.md。
合格動畫素材的硬性指標:
- Alpha 通道保留(yuva444p12le)
- ProRes 4444 編碼(profile=4)
- 解析度/幀率/時長與配置一致
- 內容覆蓋率 ≥ 50%(10 點取樣)
- 檔案大小合理(≤15MB/秒)
自動化驗證:
python verify_animation.py <動畫檔案> --duration 20 --width 1080 --height 1920
基礎動畫元件庫
位於 remotion-project/src/components/,所有元件均支援透明背景。
角色與運動元件
| 元件 | 說明 |
|---|---|
| CharacterSprite | 角色精靈:多姿態切換、位置/縮放/旋轉/透明度關鍵幀動畫 |
| MotionPath | 運動路徑:線性/貝塞爾/彈性/彈跳運動 |
| FlashEffect | 閃白特效:快速淡入緩慢淡出 |
| ShakeEffect | 震動特效:振幅衰減的隨機震動 |
| FadeEffect | 淡入淡出:可控淡入/淡出時長 |
| PopEffect | 彈出特效:彈性縮放彈出 |
| SlideEffect | 滑動特效:四方向緩出滑動 |
文字動畫元件(TextAnimations.tsx)
| 元件 | 說明 | 適用場景 |
|---|---|---|
| TextReveal | 逐字顯現:打字機/淡入/上滑/左滑 | 旁白、台詞、標題入場 |
| TextPop | 彈出文字:縮放/旋轉/彈跳 | 關鍵詞強調、卡點 |
| TextWave | 波浪文字:逐字正弦浮動 | 趣味風格、背景音樂節奏 |
| TextGlitch | 故障風:RGB 分離 + 抖動 | 科技感、故障藝術、轉場 |
| TextGradient | 漸變流光:顏色流動 + 掃光 | 標題、品牌名、高級感 |
| KineticText | 動態排版:多行組合動畫 | 開場標題、片尾字幕 |
轉場特效元件(TransitionEffects.tsx)
| 元件 | 說明 | 適用場景 |
|---|---|---|
| FadeTransition | 淡入淡出轉場(in/out/inOut) | 通用轉場、情緒過渡 |
| SlideTransition | 滑動轉場(上下左右) | 場景切換、內容替換 |
| ZoomTransition | 縮放轉場(推近/拉遠) | 強調重點、鏡頭推進 |
| WipeTransition | 擦除轉場(上下左右/對角線) | 創意轉場、風格化 |
| BlurTransition | 模糊轉場(先模糊後清晰) | 夢幻過渡、回憶閃回 |
| GlitchTransition | 故障風轉場(RGB 分離 + 掃描線) | 科技感、故障藝術 |
衝擊特效元件(ImpactEffects.tsx)
| 元件 | 說明 | 適用場景 |
|---|---|---|
| PunchImpact | 拳擊衝擊(衝擊波 + 星星 + 白閃) | 打鬥、擊打、碰撞 |
| ImpactFlash | 衝擊閃光(快速白閃) | 重擊、爆炸、卡點 |
| ParticleBurst | 粒子爆發(星星/火花/碎片) | 慶祝、爆炸、衝擊 |
| Shockwave | 衝擊波(多環擴散) | 能量釋放、爆炸、震感 |
| SpeedLines | 速度線(放射狀) | 高速衝擊、衝刺、連擊 |
使用範例:
import { PunchImpact, ParticleBurst, FadeTransition } from "./components";
// 打鬥場景
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />
使用範例:
import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";
<CharacterSprite
poses={[
{ name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
{ name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
]}
width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="被打了!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="痛!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />
專案結構
remotion-controls-skill/
├── SKILL.md # 本檔案
├── QUALITY_STANDARD.md # 動畫素材品質標準
├── verify_animation.py # 自動化驗證工具
├── remotion_controls.py # 主控制腳本(CLI/API)
├── .env.example # 環境變數範例
├── .gitignore
├── capabilities/
│ ├── cap_api_wrapper/ # Remotion API 封裝
│ ├── cap_animation_renderer/ # 動畫渲染器
│ ├── cap_template_library/ # 動畫模板庫
│ ├── cap_quality_control/ # 品質控制
│ └── cap_self_evolution/ # 自學習進化
├── remotion-project/ # Remotion 專案
│ ├── src/
│ │ ├── components/ # 基礎動畫元件庫
│ │ │ ├── CharacterSprite.tsx
│ │ │ ├── MotionPath.tsx
│ │ │ ├── Effects.tsx
│ │ │ └── index.ts
│ │ ├── AnimationTemplate.tsx # JSON 驅動的動畫模板
│ │ ├── Root.tsx
│ │ └── index.ts
│ ├── public/ # 靜態素材(角色/道具圖片)
│ └── package.json
└── out/ # 渲染輸出
能力模組
cap_api_wrapper — Remotion API 封裝
render_media():渲染影片(支援透明背景)render_still():渲染單幀圖片select_composition():取得可用 Composition 列表get_props_schema():取得 Composition 的 Props 定義
cap_animation_renderer — 動畫渲染器
- 輸入動畫指令 JSON → 輸出透明背景影片
- 支援關鍵幀動畫(位置/縮放/旋轉/透明度)
- 支援緩動曲線(ease-in/ease-out/ease-in-out/linear/spring)
- 支援多圖層合成
cap_template_library — 動畫模板庫
- 角色動畫模板(豆包被打、表情切換等)
- UI 動畫模板(按鈕點擊、頁面切換等)
- 文字動畫模板(打字機、淡入淡出、彈跳等)
- 轉場特效模板(淡入淡出、滑動、縮放等)
cap_quality_control — 品質控制
- 幀率檢測(24/30/60fps)
- 解析度檢測(1080p/4K)
- Alpha 通道完整性檢測
- 影片時長與預期比對
- 檔案大小合理性檢查
cap_self_evolution — 自學習進化
- 記錄渲染參數與效果評分
- 最佳化預設參數
- 產生最佳實踐文件
- 模板效果排行榜
環境變數
REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765
與 ai-video-editor 的整合
Remotion-controls-skill 作為 ai-video-editor 的動畫素材製作工具:
- ai-video-editor 的導演引擎輸出動畫指令
- Remotion-controls-skill 接收指令,渲染透明背景影片
- 透明背景影片作為剪映模板的動畫素材層
- 使用者替換背景後,動畫完美疊加
注意事項
- Remotion 需要 Node.js 18+ 環境
- 透明背景影片建議使用 WebM 格式(剪映相容性佳)
- 長影片渲染耗時較長,建議分段渲染後合成
- 動畫中避免使用 CSS 濾鏡(部分濾鏡不支援透明背景)