Remotion -- React での動画作成
このスキルは、Remotion コードを扱う際に使用します。Remotion を使用すると、React コンポーネントを使ってプログラムで動画を作成できます。
プロジェクトのセットアップ
npx create-video@latest my-video
cd my-video
npm start # ブラウザでプレビュー
npm run render # MP4 にレンダリング
コンポジション
<Composition> は、寸法、fps、持続時間を持つレンダリング可能な動画を定義します。
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 の型安全性のため、props には type 宣言を使用し(interface は使用しないでください)。
サイドバーでコンポジションを整理するには <Folder> を使用します。サムネイルやOG画像などの単一フレーム出力には <Still> を使用します。
アニメーション
すべてのアニメーションでは、必ず 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]);
シーケンス
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>
トランジション
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>
オーバーレイはトランジションまたは別のオーバーレイに隣接することはできません。
オーディオ
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 を使用してコンポジションの長さを動的に調整します。
オーディオを生成する
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: "Welcome to the show.",
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 };
};
アセット
ファイルを 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
トリミングには、FFmpeg ではなく trimBefore/trimAfter プロパティを優先して使用します。フォーマット変換や、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
レンダリング
# 特定のコンポジションをレンダリング
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()は使用しない - Sequence には常に
premountForを指定する - レンダリングには
<OffthreadVideo>を使用する --<video>は使わない - 持続時間は秒単位で記述し、fps を乗算する
defaultPropsの型安全性のためにsatisfiesキーワードを使用する