Communitygithub.com

BolajiOlajide/dotfiles

編寫 Remotion React 標記的最佳實踐指導。

dotfiles 是什麼?

此技能提供撰寫 Remotion React 標記的全面最佳實踐指南,涵蓋從基本動畫規則、資產管理到進階的 3D 內容、轉場和音訊處理。它指導開發者使用 `useCurrentFrame()` 與 `interpolate()` 進行動畫,並強調在 `style` 中內聯撰寫 `interpolate()` 以提升 Studio 的可編輯性。技能明確禁止使用 CSS 過渡或動畫,因為它們無法正確渲染,並推薦使用 `staticFile()` 與 `@remotion/media` 來管理媒體檔案。此外,它還介紹了文字高亮、旁白、修剪、特效套用、音訊視覺化、字幕、字型載入、Lottie 動畫嵌入、參數化影片以及 DOM 節點測量等豐富主題。此技能適用於 Claude Code、Cursor 等 AI 代理環境,幫助開發者依照最佳結構與效能原則撰寫 Remotion 專案。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BolajiOlajide/dotfiles/tree/HEAD/ai/skills/remotion-markup

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

說明文件

這是編寫 Remotion React 標記的指導方針。 如果這不相關,請改為載入 Remotion 最佳實踐。

通用規則

使用 useCurrentFrame() 和 interpolate() 來動畫化屬性。

優先使用 interpolate() 而非 spring()。

使用 Easing.bezier() 來自訂時間曲線,包含跳躍或 overshoot 的運動。 若需要彈簧動畫,則使用 Easing.spring()。

在 Studio 中需要互動的 HTML 元素應使用 Interactive:<div> 改為 <Interactive.Div>。 為 Interactive、Solid、Sequence 設定描述性的 name 屬性,例如 name="Hero title"。

import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();

  return (
    <Interactive.Div
      name="Title"
      style={{
        opacity: interpolate(frame, [0, 60], [0, 1], {
          extrapolateRight: "clamp",
          extrapolateLeft: "clamp",
          easing: Easing.bezier(0.16, 1, 0.3, 1),
        }),
      }}
    >
      Hello World!
    </Interactive.Div>
  );
};

將 interpolate() 呼叫內聯寫在 style 屬性中。 優先使用 scale、translate、rotate 這類 CSS 屬性,而非 transform。

// 👍 內聯可編輯的關鍵影格與 transform 簡寫
style={{
  scale: interpolate(frame, [0, 100], [0, 1]),
  translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
  rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}

// 👎 隱藏的值與 transform 字串在 Studio 中較難編輯
const scale = interpolate(frame, [0, 100], [0, 1]);

style={{
  transform: `scale(${scale})`,
}}

CSS 過渡或動畫是禁止的——它們無法正確渲染。 Tailwind 動畫類別名稱是禁止的——它們無法正確渲染。

將素材放在專案根目錄的 public/ 資料夾中。

使用 staticFile() 來引用 public/ 資料夾中的檔案。

使用 @remotion/media 來加入影片和音訊。 使用 <Img> 元件來加入圖片。 對於 public/ 中的檔案使用 staticFile(),或直接傳入遠端 URL:

import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";

export const MyComposition = () => {
  return (
    <>
      <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
      <Audio src={staticFile("audio.mp3")} />
      <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
      <Video src="https://remotion.media/video.mp4" />
    </>
  );
};

若要延遲內容,請將其包裹在 <Sequence> 中並使用 from。 若要限制元素的持續時間,請使用 <Sequence> 的 durationInFrames。 <Sequence> 預設為絕對填滿並覆蓋整個場景。 對於內嵌內容,請使用 layout="none"。

const Main = () => {
  const {fps} = useVideoConfig();

  return (
    <AbsoluteFill>
      <Sequence name="Background">
        <Background />
      </Sequence>
      <Sequence name="Title" from={30} durationInFrames={60} layout="none">
        <Title />
      </Sequence>
      <Sequence name="Subtitle" from={60} durationInFrames={60} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

export const Title = () => {
  const frame = useCurrentFrame();

  return (
    <div
      style={{
        opacity: interpolate(frame, [0, 60], [0, 1], {
          extrapolateRight: "clamp",
          extrapolateLeft: "clamp",
          easing: Easing.bezier(0.16, 1, 0.3, 1),
        }),
      }}
    >
      Title
    </div>
  );
};

export const Subtitle = () => {
  return <div>Subtitle</div>;
};

文字高亮與註釋

請參閱 text-highlights.md 了解文字高亮(高亮標記)、圓圈、底線、刪除線、劃掉文字、方框與括號。

旁白

請參閱 voiceover.md 了解如何使用 ElevenLabs TTS 為 Remotion 作品添加 AI 生成的旁白。

修剪

請參閱 trimming.md 了解修剪模式——裁切動畫的開頭或結尾。

嵌入影片

請參閱 embedding-videos.md 了解關於嵌入影片的進階知識——修剪、音量、速度、循環、音高。

影片編輯

請參閱 video-editing.md 了解如何在 Remotion Studio 中建構可編輯的影片時間軸。

嵌入音訊

請參閱 audio.md 了解進階音訊功能,如修剪、音量、速度、音高。

轉場

請參閱 transitions.md 了解場景轉場模式。

視覺與像素特效

建立視覺特效時,優先順序為:1. 一般的 Remotion/HTML/CSS/SVG/濾鏡/混合/遮罩動畫,2. 透過 effects.md 列出的特效(包括在透過 <HtmlInCanvas> 渲染的 HTML 上),3. 當使用者要求可重複使用或專案特定的特效時,透過 effects.md 使用自訂 createEffect(),4. 僅在沒有合適特效時才使用自訂的 <HtmlInCanvas onPaint>(詳見 html-in-canvas.md)。

有關光漏疊加層,請參閱 light-leaks.md。文件:https://www.remotion.dev/docs/effects

可用特效:brightness()、contrast()、colorKey()、duotone()、grayscale()、hue()、invert()、saturation()、tint()、linearGradient()、linearGradientTint()、thermalVision()、blur()、linearProgressiveBlur()、radialProgressiveBlur()、zoomBlur()、dropShadow()、glow()、lightTrail()、evolve()、venetianBlinds()、mirror()、scale()、uvTranslate()、xyTranslate()、barrelDistortion()、chromaticAberration()、fisheye()、cornerPin()、wave()、burlap()、emboss()、dotGrid()、halftone()、noise()、noiseDisplacement()、paper()、roughenEdges()、pattern()、pixelate()、pixelDissolve()、scanlines()、speckle()、shine()、shrinkwrap()、vignette()、contourLines()、checkerboard()、halftoneLinearGradient()、gridlines()、whiteNoise()、tvSignalOff()、lines()、rings()、waves()、zigzag()、lightLeak()、starburst()。

3D 內容

請參閱 3d.md 了解在 Remotion 中使用 Three.js 和 React Three Fiber 的 3D 內容。

音效

當需要使用音效時,請載入 ./sfx.md 檔案以取得更多資訊。

音訊視覺化

當需要將音訊視覺化(頻譜長條圖、波形圖、低音反應特效)時,請載入 ./audio-visualization.md 檔案以取得更多資訊。

字幕

當處理字幕或標題時,請載入 Remotion 字幕 技能以取得更多資訊。

Google Fonts

這是 Remotion 中載入字型的推薦方式。請參閱 google-fonts.md 了解如何載入 Google Fonts。

本地字型

請參閱 local-fonts.md 了解如何載入本地字型。

GIF

請參閱 gifs.md 了解如何顯示與 Remotion 時間軸同步的 GIF。

進階圖片

請參閱 images.md 了解圖片大小與定位、動態圖片路徑以及取得圖片尺寸。

Lottie 動畫

請參閱 lottie.md 了解如何在 Remotion 中嵌入 Lottie 動畫。

進階時間控制

請參閱 timing.md 了解使用 interpolate 與貝茲曲線緩動以及彈簧的進階時間控制。

參數化影片

請參閱 parameters.md 了解如何透過新增 Zod schema 使組合參數化。

測量 DOM 節點

請參閱 measuring-dom-nodes.md 了解如何在 Remotion 中測量 DOM 元素尺寸。

測量文字

請參閱 measuring-text.md 了解如何測量文字尺寸、將文字適配容器以及檢查溢位。

使用 FFmpeg

對於某些影片操作,例如修剪影片或檢測靜音,應使用 FFmpeg。請載入 ./ffmpeg.md 檔案以取得更多資訊。

靜音檢測

當需要檢測並修剪影片或音訊檔案中的靜音片段時,請載入 ./silence-detection.md 檔案。

動態持續時間、尺寸與資料

請參閱 calculate-metadata.md 了解如何動態設定組合的持續時間、尺寸與屬性。

進階組合

請參閱 compositions.md 了解如何定義靜態圖、資料夾、預設屬性以及如何巢狀組合。

進階排序

請參閱 sequencing.md 了解更多排序模式——延遲、修剪、限制項目持續時間。

安裝模組

使用 npx remotion add 來以正確的版本新增套件:

npx remotion add @remotion/media

這適用於 @remotion/* 套件、mediabunny、@mediabunny/* 和 zod。

預覽標記

僅在使用者想看預覽時才這樣做。

npx remotion studio --no-open

這將啟動一個長時間執行的程序並印出預覽的伺服器 URL。 如果已經啟動,則會印出該 URL。

可選:單影格渲染檢查

你可以使用 CLI 渲染單個影格來進行佈局、顏色或時間的完整性檢查。 對於瑣碎的編輯、純重構,或者當你已經從 Studio 或之前的渲染獲得足夠信心時,可以跳過此步驟。

npx remotion still [composition-id] --scale=0.25 --frame=30

在 30 fps 時,--frame=30 表示一秒鐘的位置(--frame 是從 0 開始計算的)。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

相關技能