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