Remotion 示範影片技能
此技能協助建立與維護位於下列路徑的 Remotion 影片示範:
demos/wallrun-video
它提供了以下項目的結構化指引:
- 場景建立
- 合成結構
- 可重複使用的動畫元件
- 影片節奏
- 開發者導向的解說
此技能應在處理以下項目時使用:
- Remotion 合成
- 場景元件
- 動畫解說片段
- 影片結構或序列
- 示範中使用的動畫基礎元件
專案背景
此儲存庫為一個 Nx 單一儲存庫。
Remotion 影片位於:
demos/wallrun-video
該專案為 WallRun 渲染一部開發者導向的解說影片。
目標觀眾是前端開發者,而非行銷人員。
假設觀眾了解:
- React
- TypeScript
- 元件架構
- 佈局系統
- 開發者工具
避免解釋基本的 JavaScript 概念。
設計意圖
影片應給人開發者媒體的感覺,而非產品廣告。
良好風格:
- 評論式
- 簡約
- 現代
- 自信
- 節制動畫
不良風格:
- 通用 SaaS 宣傳
- 電影預告片效果
- 大量粒子動畫
- 密集的行銷文案
優先考量:
- 可讀性
- 層次結構
- 節奏
- 清晰度
專案結構
所有程式碼應位於:
demos/wallrun-video/src
結構:
- components/ — 可重複使用的呈現基礎元件
- scenes/ — 影片中有時間區段的章節
- data/ — 腳本、文案、時間常數
- Root.tsx — 註冊合成
- index.ts — Remotion CLI 的進入點
場景設計規則
每個場景應只傳達一個概念。
典型時長:4–8 秒
場景應:
- 快速閱讀
- 使用大字體
- 避免雜亂
- 保持動畫柔和
偏好的場景類型:
- 標題卡
- 分階段的儲存庫截圖
- 元件特寫
- 標註疊加層
- 架構圖
- 統計面板
避免:
- 小型 UI
- 長段落
- 過於複雜的轉場
動畫指南
偏好簡單且確定性的動畫。
範例:
- 淡入
- 向上滑入
- 階梯式顯示
- 輕微縮放
避免:
- 彈跳效果
- 複雜物理運動
- 沉重的緩動曲線
目標是清晰度,而非炫技。
編碼慣例
使用:
- React 函式元件
- TypeScript
- 具名匯出
- 明確型別
- 可重複使用的動畫包裝器
避免:
- 重複的動畫程式碼
- 魔術數字
- 硬編碼的場景時間
盡可能提取時間常數。
範例:
const TITLE_FADE_IN = 20;
const CALLOUT_DELAY = 15;
建立新場景的預設工作流程
- 定義場景的訊息
- 定義持續時間(以幀為單位)
- 規劃佈局
- 加入主要動畫
- 僅在能提升清晰度時加入次要動畫
- 檢查可讀性
- 確保程式碼可重複使用
Nx 目標
- preview —
nx preview wallrun-video開啟 Remotion Studio - render —
nx render wallrun-video將完整影片渲染至dist/demos/wallrun-video/ - type-check —
nx type-check wallrun-video執行 TypeScript 編譯器
完成定義
一個場景在以下情況視為完成:
- 訊息能立即被理解
- 字體在影片比例下可讀
- 動畫受到節制
- 時間設定易於編輯
- 程式碼結構清晰