Communitygithub.com

echoleesong/claude-skills-plugin

在 React 中使用 Remotion 進行影片創作的最佳實務。

claude-skills-plugin 是什麼?

這個技能提供使用 Remotion(一個以 React 為基礎的程式化影片製作函式庫)完整的開發指引。它能協助 AI 代理設定新專案、設計動畫、管理素材資源,以及處理進階功能,例如字幕、音訊視覺化、3D 整合和轉場效果。支援的平台包含 Claude Code、Cursor 和 Codex 等 AI 編碼工具。該技能強調正確的做法,例如使用 `useCurrentFrame()` 和 `interpolate()` 進行動畫製作、使用 `<Sequence>` 進行時間軸管理,並透過多個規則檔案明確禁止使用 CSS 動畫。它將主題分門別類,涵蓋 Google 字型、本機字型、GIF、Lottie 動畫、參數化影片和 AI 語音旁白等進階主題,讓 AI 代理能提供符合 Remotion 最佳實務的準確建議。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/echoleesong/claude-skills-plugin/tree/HEAD/skills/remotion

在你喜歡的 AI 中提問

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

預覽

來自技能 README

說明文件

使用時機

每當你處理 Remotion 程式碼時,請使用此技能以取得領域特定知識。

新專案設定

當位於空的資料夾或工作區,且沒有現有的 Remotion 專案時,請使用以下指令建立一個新專案:

npx create-video@latest --yes --blank --no-tailwind my-video

將 my-video 替換為合適的專案名稱。

設計影片

使用 useCurrentFrame() 和 interpolate() 來製作屬性動畫。使用 Easing 來客製化動畫的時間曲線。

import { useCurrentFrame, Easing } from "remotion";

export const FadeIn = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Hello World!</div>;
};

禁止使用 CSS 轉場或動畫——它們無法正確渲染。 禁止使用 Tailwind 動畫類別名稱——它們無法正確渲染。

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

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

使用 <Img> 元件來加入圖片:

import { Img, staticFile } from "remotion";

export const MyComposition = () => {
  return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};

使用 @remotion/media 中的 <Video> 元件來加入影片:

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

export const MyComposition = () => {
  return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};

使用 @remotion/media 中的 <Audio> 元件來加入音訊:

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

export const MyComposition = () => {
  return <Audio src={staticFile("audio.mp3")} />;
};

素材資源也可以透過遠端 URL 引用:

import { Video } from "@remotion/media";

export const MyComposition = () => {
  return <Video src="https://remotion.media/video.mp4" />
};

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

import { Sequence } from "remotion";

export const Title = () => {
  const frame = useCurrentFrame();
  const { fps } = useVideoConfig();

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
    extrapolateLeft: "clamp",
    easing: Easing.bezier(0.16, 1, 0.3, 1),
  });

  return <div style={{ opacity }}>Title</div>;
};

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

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

  return (
    <AbsoluteFill>
      <Sequence>
        <Background />
      </Sequence>
      <Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
        <Title />
      </Sequence>
      <Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
        <Subtitle />
      </Sequence>
    </AbsoluteFill>
  );
}

影片的寬度、高度、FPS 和持續時間是在 src/Root.tsx 中定義:

import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      durationInFrames={100}
      fps={30}
      width={1080}
      height={1080}
    />
  );
};

也可以動態計算後設資料:

import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";

const calculateMetadata: CalculateMetadataFunction<
  MyCompositionProps
> = async ({ props, abortSignal }) => {
  const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
    signal: abortSignal,
  }).then((res) => res.json());

  return {
    durationInFrames: Math.ceil(data.duration * 30),
    props: {
      ...props,
      videoUrl: data.url,
    },
    width: 1080,
    height: 1080,
  };
};

export const RemotionRoot = () => {
  return (
    <Composition
      id="MyComposition"
      component={MyComposition}
      fps={30}
      width={1080}
      height={1080}
      defaultProps={{ videoId: "abc123" }}
      calculateMetadata={calculateMetadata}
    />
  );
};

啟動預覽

啟動 Remotion Studio 來預覽影片:

npx remotion studio

選用:單幀渲染檢查

你可以使用 CLI 渲染單一幀來進行版面、顏色或時間點的 sanity check。 對於瑣碎的編輯、純重構,或當你已經從 Studio 或之前的渲染中獲得足夠信心時,可以跳過此步驟。

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

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

字幕

處理字幕或標題時,請載入 ./rules/subtitles.md 檔案以獲取更多資訊。

使用 FFmpeg

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

靜音偵測

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

音訊視覺化

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

音效

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

3D 內容

關於使用 Three.js 和 React Three Fiber 在 Remotion 中製作 3D 內容,請參閱 rules/3d.md。

進階音訊

關於修剪、音量、速度、音高等進階音訊功能,請參閱 rules/audio.md。

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

關於動態設定 Composition 的持續時間、尺寸和 props,請參閱 rules/calculate-metadata.md。

進階 Composition

關於如何定義靜態圖片、資料夾、預設 props 以及如何巢狀 Composition,請參閱 rules/compositions.md。

Google Fonts

這是在 Remotion 中載入字型的推薦方式。關於如何載入 Google Fonts,請參閱 rules/google-fonts.md。

本機字型

關於如何載入本機字型,請參閱 rules/local-fonts.md。

取得音訊持續時間

關於使用 Mediabunny 取得音訊檔案持續時間(以秒為單位),請參閱 rules/get-audio-duration.md。

取得影片尺寸

關於使用 Mediabunny 取得影片檔案的寬度和高度,請參閱 rules/get-video-dimensions.md。

取得影片持續時間

關於使用 Mediabunny 取得影片檔案持續時間(以秒為單位),請參閱 rules/get-video-duration.md。

GIF

關於如何顯示與 Remotion 時間軸同步的 GIF,請參閱 rules/gifs.md。

進階圖片

關於調整圖片大小和位置、動態圖片路徑以及取得圖片尺寸,請參閱 rules/images.md。

漏光效果

關於使用 @remotion/light-leaks 製作漏光疊加效果,請參閱 rules/light-leaks.md。

Lottie 動畫

關於在 Remotion 中嵌入 Lottie 動畫,請參閱 rules/lottie.md。

Canvas 中的 HTML

如果你需要將 HTML 渲染到 <canvas> 中以透過 <HtmlInCanvas> 套用 2D 或 WebGL 效果,請參閱 rules/html-in-canvas.md。

測量 DOM 節點

關於在 Remotion 中測量 DOM 元素尺寸,請參閱 rules/measuring-dom-nodes.md。

測量文字

關於測量文字尺寸、將文字適合容器以及檢查溢位,請參閱 rules/measuring-text.md。

進階序列化

關於更多序列化模式——延遲、修剪、限制項目持續時間,請參閱 rules/sequencing.md。

TailwindCSS

關於在 Remotion 中使用 TailwindCSS,請參閱 rules/tailwind.md。

文字動畫

關於排版和文字動畫模式,請參閱 rules/text-animations.md。

進階時間控制

關於使用 interpolate、貝茲緩動和彈簧進行進階時間控制,請參閱 rules/timing.md。

轉場

關於場景轉場模式,請參閱 rules/transitions.md。

透明影片

關於渲染出帶有透明背景的影片,請參閱 rules/transparent-videos.md。

修剪

關於修剪模式——剪掉動畫的開頭或結尾,請參閱 rules/trimming.md。

進階影片

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

參數化影片

關於透過加入 Zod schema 使 Composition 可參數化,請參閱 rules/parameters.md。

地圖

對於簡單且少有飛越鏡頭的地圖,請考慮使用靜態地圖圖片。 對於具有動畫路線或飛越鏡頭的複雜地圖,請載入地圖規則: rules/maplibre.md

語音旁白

關於使用 ElevenLabs TTS 為 Remotion Composition 加入 AI 生成的語音旁白,請參閱 rules/voiceover.md。

相關技能