使用時機
每當您讀取或編寫 Remotion 程式碼時,從建立專案到渲染最終影片,請載入此技能。
常見的 AI 錯誤避免清單
在提交前,請針對以下重複出現的失敗模式檢查每個 Remotion 程式碼變更:
- 非確定性隨機性 — 使用來自
remotion的random(seed),絕不使用Math.random()、Date.now()或new Date()。否則,並行渲染會產生閃爍雜訊。 - 未記憶化的
<Player>inputProps— 始終傳遞記憶化的 props;未記憶化的 props 會導致整個元件樹的重新渲染風暴。 - 遺漏
delayRender()/continueRender()— 在非同步工作(fetch、字型載入、測量)周圍使用。缺少它們會導致渲染在 30,000 毫秒時掛起。 - 字幕上非單調的
inputRange—interpolate的inputRange必須嚴格遞增。對於短片段,請使用Math.min(10, Math.floor(duration / 3))作為淡入/淡出視窗。 - 處處使用線性緩動 — 優先使用
spring()實現自然運動;僅在明確的技術需求時才使用線性緩動。 - 遺漏
@remotion/google-fonts導入 — 每個字型都需要明確的loadFont({ weights, subsets })呼叫。 - 單一的單一構圖輸出 — 將場景分解為小型的聚焦構圖,並使用
<Sequence>或<TransitionSeries>組合。 - 已棄用的
startFrom/endAt— 改用trimBefore/trimAfter。
新專案設定
當在一個空的資料夾或沒有現有 Remotion 專案的工作區中時,請使用以下指令建立一個:
npx create-video@latest --yes --blank --no-tailwind my-video
將 my-video 替換為合適的專案名稱。
啟動預覽
啟動 Remotion Studio 以預覽影片:
npx remotion studio
可選:單幀渲染檢查
您可以使用 CLI 渲染單個幀,以進行佈局、顏色或時間的健全性檢查。 對於瑣碎的編輯、純重構,或者當您已從 Studio 或先前的渲染中獲得足夠信心時,可以跳過此步驟。
npx remotion still [composition-id] --scale=0.25 --frame=30
在 30 fps 下,--frame=30 表示一秒鐘的標記(--frame 是從零開始的)。
規則索引
閱讀各個規則檔案以獲取詳細說明和程式碼範例。
核心
- core/compositions.md - 定義構圖、靜態圖、資料夾、預設 props 和動態元資料
- core/sequencing.md - 排序模式 - 延遲、修剪、限制項目的持續時間
- core/timing.md - 使用 interpolate、貝茲緩動和彈簧進行時間控制
- core/animations.md - 基礎動畫技巧
- core/trimming.md - 修剪動畫的開頭或結尾
- core/parameters.md - 使用 Zod 架構使影片參數化
- core/calculate-metadata.md - 動態設定構圖持續時間、尺寸和 props
- core/primitives.md - 佈局和時間控制原語:Loop、Freeze、Series、Null、IFrame、AnimatedImage、premount
媒體
- media/images.md - 使用 Img 組件嵌入圖像
- media/videos.md - 嵌入影片 - 修剪、音量、速度、循環
- media/gifs.md - 顯示與 Remotion 時間線同步的 GIF
- media/lottie.md - 嵌入 Lottie 動畫
- media/transparent-videos.md - 渲染具有透明度的影片
- media/assets.md - 導入圖像、影片、音訊和字型
- media/light-leaks.md - 漏光疊加效果
- media/3d.md - 使用 Three.js 和 React Three Fiber 的 3D 內容
音訊
- audio/audio.md - 使用音訊和聲音 - 導入、修剪、音量、速度、音高
- audio/voiceover.md - 使用 ElevenLabs TTS 的 AI 生成旁白
- audio/audio-visualization.md - 視覺化音訊(頻譜條、波形、低音反應)
- audio/silence-detection.md - 使用 FFmpeg 的適應性靜音檢測
- audio/sfx.md - 使用音效
- audio/subtitles.md - 字幕和標題概述
- audio/get-audio-duration.md - 使用 Mediabunny 獲取音訊檔案的持續時間
- audio/ai-captions.md - AI 轉錄:@remotion/openai-whisper、whisper-web、install-whisper-cpp
文字
- text/text-animations.md - 排版和文字動畫模式
- text/measuring-text.md - 測量文字尺寸,將文字適配到容器中
- text/fonts.md - 載入 Google 字型和本地字型
- text/google-fonts.md - @remotion/google-fonts 每個字型的套件,包含所需的權重/子集
- text/display-captions.md - 在畫面上渲染字幕
- text/import-srt-captions.md - 導入 SRT 字幕檔案
進階
- advanced/maps.md - 使用 Mapbox 添加地圖並對其進行動畫處理
- advanced/charts.md - 圖表和資料視覺化(長條圖、圓餅圖、折線圖、股票圖)
- advanced/transitions.md - 場景轉換模式(基礎)
- advanced/transitions-package.md - @remotion/transitions 完整參考 - 演示、時間控制、自訂
- advanced/tailwind.md - 在 Remotion 中使用 TailwindCSS
- advanced/measuring-dom-nodes.md - 測量 DOM 元素尺寸
- advanced/hdr.md - 色彩空間和 HDR 輸出:bt709、displayp3、rec2020、ProRes
工具
- utilities/ffmpeg.md - 使用 FFmpeg 進行影片操作
- utilities/can-decode.md - 使用 Mediabunny 檢查影片是否可以解碼
- utilities/extract-frames.md - 在特定時間戳提取幀
- utilities/get-video-dimensions.md - 獲取影片檔案的寬度和高度
- utilities/get-video-duration.md - 獲取影片檔案的持續時間(以秒為單位)
- utilities/transcribe-captions.md - 轉錄字幕
生產環境
- production/delay-render.md - 在非同步工作期間暫停渲染:delayRender、continueRender、cancelRender
- production/determinism.md - 使用 random(seed) 進行確定性渲染;絕不使用 Math.random / Date.now
- production/rendering.md - @remotion/renderer Node SSR:bundle、selectComposition、renderMedia
- production/cli.md - npx remotion 子指令和標誌(render、still、bundle、studio、benchmark)
- production/config.md - remotion.config.ts Config 設定器(codec、CRF、concurrency、Webpack)
- production/lambda.md - AWS Lambda:deployFunction、deploySite、renderMediaOnLambda、成本調整
- production/player.md - @remotion/player 嵌入、PlayerRef、記憶化的 inputProps、緩衝區事件
- production/video-tag-decision.md - 選擇 Video / OffthreadVideo / Html5Video / @remotion/media
- production/input-props.md - Props 解析順序、Zod 驗證、--props CLI 標誌、渲染邊界安全性
- production/caption-timing-safety.md - 字幕的單調 inputRange 和適應性淡入/淡出視窗
- production/performance.md - 硬體加速、並行性、圖像格式、GPU 預計算、基準測試
- production/env-vars.md - REMOTION_ 前綴、.env 載入、透過 inputProps / envVariables 的機密
整合
- integration/nextjs.md - Next.js App Router:Player SSR 防護、transpilePackages、用於 Lambda 的 API 路由
- integration/docker.md - Docker:基礎映像、--shm-size、字型、Chromium 標誌、CI 範例
- integration/mediabunny-migration.md - 從已棄用的 media-parser/webcodecs 遷移到 Mediabunny Video/Audio
- integration/v5-prep.md - 使 v4 程式碼面向未來,以應對 v5 的重大變更
套件
- packages/paths.md - @remotion/paths SVG 路徑工具(interpolatePath、warpPath、getLength)
- packages/shapes.md - @remotion/shapes 預建 SVG 基本形狀(三角形、圓形、星形、圓餅圖、心形)
- packages/noise.md - @remotion/noise 基於種子的 Perlin 雜訊(noise2D、noise3D、noise4D)
- packages/motion-blur.md - @remotion/motion-blur Trail 和 CameraMotionBlur(謹慎使用)
- packages/skia.md - @remotion/skia 高效能畫布(React Native Skia)
- packages/rive.md - @remotion/rive 帶狀態機的動畫(Lottie 替代方案)