Communitygithub.com

tinh2/skills-hub-registry

使用 Remotion(React)編寫程式化影片,涵蓋組合、動畫、序列、轉場、音訊/影片嵌入、彈簧物理、文字動畫、ElevenLabs TTS 語音生成、FFmpeg 整合、字幕、3D 和渲染,遵循官方最佳實踐。

skills-hub-registry 是什麼?

這是一項關於 Remotion 影片開發的 AI 技能,讓你能夠在 React 中完全以程式碼建立影片。它涵蓋了從專案初始化、Composition 設定、使用 `useCurrentFrame()` 進行動畫製作、彈簧物理與插值技術,到 Sequence 和 Series 的排序、TransitionSeries 的轉場效果,以及音訊與影片的嵌入與剪輯。此外,技能還包括透過 ElevenLabs TTS 生成語音旁白、使用 FFmpeg 進行格式轉換、字幕與 3D 整合,以及最終渲染輸出。此技能基於官方最佳實踐,強調避免 CSS 動畫和 Tailwind 動畫類別,必須使用 `staticFile()` 引用資源,並推薦使用 `OffthreadVideo` 提升渲染效能。支援所有主流 Remotion 平台(CLI、Node.js)。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/tinh2/skills-hub-registry/tree/HEAD/build/remotion

在你喜歡的 AI 中提問

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

說明文件

Remotion -- 在 React 中建立影片

當你使用 Remotion 程式碼時,請使用此技能。Remotion 讓你能夠使用 React 元件以程式化方式建立影片。

專案設定

npx create-video@latest my-video
cd my-video
npm start        # 在瀏覽器中預覽
npm run render   # 渲染為 MP4

組合 (Compositions)

一個 <Composition> 定義了一個可渲染的影片,包含尺寸、影格率和長度。

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

export const RemotionRoot = () => (
  <Composition
    id="MyVideo"
    component={MyVideo}
    durationInFrames={300}
    fps={30}
    width={1920}
    height={1080}
    defaultProps={{ title: "Hello World" } satisfies MyVideoProps}
  />
);

為了 defaultProps 的型別安全,請使用 type 宣告 props(不要使用 interface)。

使用 <Folder> 在側邊欄中組織 compositions。使用 <Still> 用於單幀輸出(縮圖、OG 圖片)。

動畫

所有動畫必須使用 useCurrentFrame()。CSS 過渡效果和 Tailwind 動畫類別是禁止的——它們無法正確渲染。

import { useCurrentFrame, useVideoConfig, interpolate } from "remotion";

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

  const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
    extrapolateRight: "clamp",
  });

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

彈簧動畫

彈簧提供自然的運動。它們從 0 動畫到 1。

import { spring, useCurrentFrame, useVideoConfig } from "remotion";

const frame = useCurrentFrame();
const { fps } = useVideoConfig();

const scale = spring({ frame, fps });
// 配置參數:
const smooth = spring({ frame, fps, config: { damping: 200 } }); // 無彈跳
const snappy = spring({ frame, fps, config: { damping: 20, stiffness: 200 } });
const bouncy = spring({ frame, fps, config: { damping: 8 } });
const heavy  = spring({ frame, fps, config: { damping: 15, stiffness: 80, mass: 2 } });

使用 delay 參數來延遲彈簧啟動:

const entrance = spring({ frame, fps, delay: 20 });

插值

// 帶限制的線性插值
const opacity = interpolate(frame, [0, 100], [0, 1], {
  extrapolateRight: "clamp",
  extrapolateLeft: "clamp",
});

// 多步驟插值
const y = interpolate(frame, [0, 30, 60, 90], [100, 0, 0, -100]);

序列 (Sequencing)

Sequence

使用 <Sequence> 來延遲元素出現的時間。始終使用 premountFor 來預載元件。

import { Sequence } from "remotion";

const { fps } = useVideoConfig();

<Sequence from={1 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
  <Subtitle />
</Sequence>

使用 layout="none" 來防止絕對定位的包裝器。

Series

使用 <Series> 進行不重疊的順序播放:

import { Series } from "remotion";

<Series>
  <Series.Sequence durationInFrames={45}><Intro /></Series.Sequence>
  <Series.Sequence durationInFrames={60}><MainContent /></Series.Sequence>
  <Series.Sequence durationInFrames={30}><Outro /></Series.Sequence>
</Series>

負數的 offset 會產生重疊的過渡效果:

<Series.Sequence offset={-15} durationInFrames={60}>
  <SceneB />
</Series.Sequence>

轉場 (Transitions)

npx remotion add @remotion/transitions
import { TransitionSeries, linearTiming } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
import { wipe } from "@remotion/transitions/wipe";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Transition
    presentation={fade()}
    timing={linearTiming({ durationInFrames: 15 })}
  />
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

漏光遮罩

import { LightLeak } from "@remotion/light-leaks";

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneA />
  </TransitionSeries.Sequence>
  <TransitionSeries.Overlay durationInFrames={20}>
    <LightLeak />
  </TransitionSeries.Overlay>
  <TransitionSeries.Sequence durationInFrames={60}>
    <SceneB />
  </TransitionSeries.Sequence>
</TransitionSeries>

一個 overlay 不能與一個 transition 或另一個 overlay 相鄰。

音訊

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

// 基本音訊
<Audio src={staticFile("audio.mp3")} />

// 帶剪輯(值以影格為單位)
<Audio src={staticFile("audio.mp3")} trimBefore={2 * fps} trimAfter={10 * fps} />

// 音量控制
<Audio src={staticFile("audio.mp3")} volume={0.5} />

// 動態音量(回調接收影格)
<Audio src={staticFile("audio.mp3")} volume={(f) =>
  interpolate(f, [0, 30], [0, 1], { extrapolateRight: "clamp" })
} />

// 速度改變
<Audio src={staticFile("audio.mp3")} playbackRate={1.5} />

// 延遲音訊開始
<Sequence from={1 * fps}>
  <Audio src={staticFile("audio.mp3")} />
</Sequence>

多個 <Audio> 元件會自動分層疊加。

影片嵌入

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

// 基本影片
<Video src={staticFile("video.mp4")} />

// 帶剪輯
<Video src={staticFile("video.mp4")} trimBefore={2 * fps} trimAfter={10 * fps} />

// 速度、音量、循環
<Video src={staticFile("video.mp4")} playbackRate={2} volume={0.5} loop />

// 為了渲染效能,請使用 OffthreadVideo
import { OffthreadVideo } from "remotion";
<OffthreadVideo src={staticFile("video.mp4")} />

始終使用 <OffthreadVideo> 以獲得更好的渲染效能。僅在預覽時使用 <Video>。

使用 ElevenLabs TTS 的語音旁白

為每個場景生成語音,然後使用 calculateMetadata 動態調整 composition 的長度。

生成音訊

const response = await fetch(
  `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`,
  {
    method: "POST",
    headers: {
      "xi-api-key": process.env.ELEVENLABS_API_KEY!,
      "Content-Type": "application/json",
      Accept: "audio/mpeg",
    },
    body: JSON.stringify({
      text: "歡迎來到這場秀。",
      model_id: "eleven_multilingual_v2",
      voice_settings: { stability: 0.5, similarity_boost: 0.75, style: 0.3 },
    }),
  },
);
const audioBuffer = Buffer.from(await response.arrayBuffer());
writeFileSync(`public/voiceover/scene-01.mp3`, audioBuffer);

動態長度

import { CalculateMetadataFunction, staticFile } from "remotion";

const FPS = 30;
const SCENES = ["voiceover/scene-01.mp3", "voiceover/scene-02.mp3"];

export const calculateMetadata: CalculateMetadataFunction<Props> = async () => {
  const durations = await Promise.all(
    SCENES.map((file) => getAudioDuration(staticFile(file)))
  );
  const totalFrames = durations.reduce((sum, d) => sum + Math.ceil(d * FPS), 0);
  return { durationInFrames: totalFrames };
};

資源 (Assets)

將檔案放在 public/ 目錄中,並使用 staticFile() 引用:

import { staticFile, Img } from "remotion";

<Img src={staticFile("logo.png")} />

永遠不要使用 require() 或 import 來載入媒體檔案。始終使用 staticFile()。

字型

import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();

// 或使用本地字型
const { fontFamily } = loadFont({
  url: staticFile("fonts/MyFont.woff2"),
  display: "swap",
});

在 Remotion 中使用 FFmpeg

FFmpeg 已內建——無需安裝:

bunx remotion ffmpeg -i input.mp4 output.mp3
bunx remotion ffprobe input.mp4

對於剪輯,優先使用 trimBefore/trimAfter 屬性,而不是 FFmpeg。對於格式轉換或 Remotion 本身無法完成的操作,請使用 FFmpeg。

使用 FFmpeg 進行剪輯時,必須重新編碼以避免凍結畫面:

bunx remotion ffmpeg -ss 00:00:05 -i public/input.mp4 -to 00:00:10 -c:v libx264 -c:a aac public/output.mp4

渲染

# 渲染特定 composition
npx remotion render MyVideo output.mp4

# 渲染靜態影格
npx remotion still MyVideo --frame=100 thumbnail.png

# 使用自訂 props
npx remotion render MyVideo output.mp4 --props='{"title": "Custom"}'

# 特定編碼器
npx remotion render MyVideo output.webm --codec=vp8

常見模式

基於場景的影片

const SCENES = [
  { component: TitleScene, duration: 90 },
  { component: ProblemScene, duration: 150 },
  { component: SolutionScene, duration: 120 },
  { component: CTAScene, duration: 90 },
];

export const MyVideo = () => {
  let offset = 0;
  return (
    <>
      {SCENES.map(({ component: Component, duration }, i) => {
        const from = offset;
        offset += duration;
        return (
          <Sequence key={i} from={from} durationInFrames={duration}>
            <Component />
          </Sequence>
        );
      })}
    </>
  );
};

背景音樂 + 語音旁白

<>
  {/* 低音量的背景音樂 */}
  <Audio src={staticFile("music/bg.mp3")} volume={0.12} loop />

  {/* 全音量的場景旁白 */}
  <Sequence from={0} durationInFrames={scene1Frames}>
    <Audio src={staticFile("voiceover/scene-01.mp3")} volume={1} />
  </Sequence>
  <Sequence from={scene1Frames} durationInFrames={scene2Frames}>
    <Audio src={staticFile("voiceover/scene-02.mp3")} volume={1} />
  </Sequence>
</>

關鍵規則

  1. 不使用 CSS 動畫——所有運動通過 useCurrentFrame() + interpolate()/spring() 實現
  2. 不使用 Tailwind 動畫類別——它們無法正確渲染
  3. 資源始終用 staticFile(),絕不使用 require()
  4. 始終使用 premountFor 預載 Sequences
  5. 使用 <OffthreadVideo> 而不是 <video> 進行渲染
  6. 以秒為單位編寫持續時間,然後乘以 fps
  7. 使用 satisfies 關鍵字 確保 defaultProps 的型別安全

來源:remotion-dev/skills、remotion.dev

相關技能