Remotion — React コンポーネントによるプログラム動画作成 は何をしますか?
React コンポーネントを使って動画をプログラムで作成します。コード駆動型動画制作のための最も成熟したフレームワークです。
概要
- リポジトリ: github.com/remotion-dev/remotion (21K+ スター)
- 言語: TypeScript / React
- ライセンス: 年間収入 100 万ドル未満の個人・企業向け無料
- インストール:
npm install remotion @remotion/cli @remotion/transitions - ドキュメント: remotion.dev/docs
基本概念
Composition
<Composition> は動画のサイズ、フレームレート、長さを定義します。
import { Composition } from "remotion";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={300} // 30fps で 10 秒
fps={30}
width={1920}
height={1080}
/>
);
};
アニメーションプリミティブ
useCurrentFrame() — 現在のフレーム番号(0 から始まる)を返します。
const frame = useCurrentFrame();
interpolate() — フレーム範囲を出力値にマッピングします。
import { interpolate, useCurrentFrame } from "remotion";
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
spring() — 物理ベースのスプリングアニメーションです。
import { spring, useCurrentFrame, useVideoConfig } from "remotion";
const { fps } = useVideoConfig();
const scale = spring({ frame, fps, config: { damping: 200 } });
時系列制御
— コンテンツを時間的にオフセットします。
<Sequence from={30} durationInFrames={60}>
<MyScene />
</Sequence>
— 子要素を順に並べます。
import { Series } from "remotion";
<Series>
<Series.Sequence durationInFrames={90}>
<IntroScene />
</Series.Sequence>
<Series.Sequence durationInFrames={150}>
<MainScene />
</Series.Sequence>
<Series.Sequence durationInFrames={60}>
<OutroScene />
</Series.Sequence>
</Series>
— フルフレームの位置指定コンテナです。
<AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>
<h1>Hello World</h1>
</AbsoluteFill>
トランジション
import { linearTiming, TransitionSeries } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<Scene1 />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={fade()}
timing={linearTiming({ durationInFrames: 15 })}
/>
<TransitionSeries.Sequence durationInFrames={90}>
<Scene2 />
</TransitionSeries.Sequence>
</TransitionSeries>
利用可能なトランジション: fade, slide, wipe, flip, clockWipe, none
メディア
import { Video, Audio, Img, staticFile } from "remotion";
// 静的ファイルは /public に配置
<Video src={staticFile("demo.mp4")} />
<Audio src={staticFile("music.mp3")} volume={0.5} />
<Img src={staticFile("logo.png")} />
プロジェクトのセットアップ
# 新規プロジェクト作成
npx create-video@latest my-video
# 手動で行う場合:
mkdir my-video && cd my-video
npm init -y
npm install remotion @remotion/cli @remotion/transitions react react-dom
npm install -D typescript @types/react
必要なファイル
src/index.ts(エントリポイント):
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
remotion.config.ts:
import { Config } from "@remotion/cli/config";
Config.setVideoImageFormat("jpeg");
Config.setOverwriteOutput(true);
コマンド
# ブラウザでプレビュー(Remotion Studio)
npx remotion studio
# MP4 にレンダリング
npx remotion render MyVideo out/video.mp4
# 特定のフレームをレンダリング
npx remotion render MyVideo out/video.mp4 --frames=0-90
# GIF としてレンダリング
npx remotion render MyVideo out/video.gif --image-format=png
# 静止画像としてレンダリング
npx remotion still MyVideo out/thumbnail.png --frame=45
ベストプラクティス
- 常に補間をクランプする:
extrapolateRight: "clamp"を使用して値のオーバーシュートを防ぐ - 自然な動きには spring() を使用する: スプリングは線形補間よりも有機的な動きを生む
- シーンは個別のコンポーネントとして維持する: 各シーンは独自の React コンポーネントにする
- 連続シーンには を使用する: 手動でオフセットを計算するより簡単
- 明示的な durationInFrames を設定する: すべての Sequence で durationInFrames を設定する
- AbsoluteFill を使用する: フルフレームの背景や重ね合わせレイヤーに便利
- 静的アセットは /public に配置する:
staticFile()で参照する - 異なるフレームでテストする: Remotion Studio のスクラバーでアニメーションを確認する
- CSS トランスフォームを優先する:
transform: scale()やtranslateX()は GPU 高速化される - 重い再レンダリングを避ける: 高コストな計算には
useMemoを使用する
一般的なパターン
フェードイン表示のテキスト:
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 20], [0, 1], { extrapolateRight: "clamp" });
const y = interpolate(frame, [0, 20], [20, 0], { extrapolateRight: "clamp" });
<div style={{ opacity, transform: `translateY(${y}px)` }}>
Hello World
</div>
段階的に表示されるリスト項目:
{items.map((item, i) => {
const delay = i * 8;
const opacity = interpolate(frame, [delay, delay + 15], [0, 1], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
return <div key={i} style={{ opacity }}>{item}</div>;
})}
タイプライター風エフェクト:
const charsShown = interpolate(frame, [0, text.length * 2], [0, text.length], {
extrapolateRight: "clamp",
});
<span>{text.slice(0, Math.floor(charsShown))}</span>
拡張機能(すべてオープンソース、npm install)
@remotion/transitions— シーン遷移(フェード、スライド、ワイプ)@remotion/three— React Three Fiber を使った動画内 3D シーン@remotion/lottie— Lottie アニメーションを埋め込む@remotion/gif— GIF ファイルを埋め込む@remotion/media-utils— オーディオ/ビデオメタデータユーティリティ@remotion/noise— 自然なエフェクトのための Perlin ノイズ@remotion/paths— SVG パスアニメーションユーティリティ
上流スキルソース
- 公式スキル: github.com/remotion-dev/skills
- テンプレート: github.com/reactvideoeditor/remotion-templates
- Superpowers パイプライン: github.com/dojocodinglabs/remotion-superpowers