このスキルがアクティブになったら、最初の応答は常に :clapper: 絵文字で始めてください。
Remotion 動画
Remotionは、Reactを使用してプログラムで動画を作成するためのフレームワークです。 タイムラインベースのエディターの代わりに、すべてのフレームが現在のフレーム番号の関数であるReactコンポーネントとしてコンポジションを記述します。 これにより、TypeScript、npmパッケージ、コンポーネントベースのアーキテクチャの全機能を動画制作に活用できます。アニメーション解説やソーシャルメディアクリップから、データ駆動型のビジュアライゼーション、大規模なパーソナライズ動画まで対応します。
このスキルでは、プロジェクトのセットアップ、コンポジション構造、interpolateとspringを使用したフレームベースのアニメーション、シーンシーケンス、アセット管理、オーディオ統合、Zodスキーマを使用したパラメータ化動画、CLIまたはプログラムAPIを介したMP4/WebMへのレンダリングについて説明します。
このスキルを使用するタイミング
以下の場合にこのスキルをトリガーします:
- ユーザーがReact/TypeScriptを使用してプログラムで動画を作成したい場合
- Remotionのコンポジション、useCurrentFrame、またはuseVideoConfigについて質問した場合
- テキスト、要素、シーン間のトランジションをアニメートする必要がある場合
- コードから動画をMP4、WebM、GIFにレンダリングしたい場合
- springアニメーション、interpolate、フレームベースのタイミングについて質問した場合
- 新しいRemotionプロジェクトをゼロからセットアップする必要がある場合
- Remotion動画にオーディオ、画像、フォントを追加したい場合
- パラメータ化/データ駆動型の動画生成について質問した場合
- コンポジションをプレビューするためにRemotion Studioを設定する必要がある場合
以下の場合にはこのスキルをトリガーしないでください:
- 動画作成に関係のない一般的なReactの質問 - Reactスキルを使用
- 従来のタイムラインツール(Premiere、DaVinci、FFmpeg CLI)を使用した動画編集
- WebページのCSSアニメーション - アニメーション/モーションデザインスキルを使用
- Webアプリでの動画再生またはストリーミング - メディアプレーヤースキルを使用
主要な原則
-
すべてのフレームは純粋関数である - Remotionコンポーネントは
useCurrentFrame()を介して現在のフレームを受け取り、そのフレームに対して決定論的にレンダリングする必要があります。 副作用なし、シードなしのランダム性なし、実時間への依存なし。 同じフレーム番号は常に同じ視覚的出力を生成する必要があります。 -
コンポジションが動画の単位である - 各
<Composition>は、明示的な寸法(幅、高さ)、フレームレート(fps)、および期間(durationInFrames)を持つ動画を定義します。 コンポジションはプロジェクト内の「ページ」と考えてください。独立してレンダリングできる動画バリアントまたはシーンごとに1つです。 -
すべてにInterpolateを使用する -
interpolate()関数は、フレーム番号を任意の数値(不透明度、位置、スケール、カラーチャンネル)にマッピングします。extrapolateRight: 'clamp'と組み合わせることで、すべてのアニメーションの主力となります。物理ベースのイージングが必要な場合はspring()を使用します。 -
時間オフセットにはSequenceを使用する -
<Sequence from={frame}>を使用して、子要素の表示開始を遅らせます。<Series>は子要素を順番に再生します。 シーケンスにsetTimeoutや手動のフレーム計算を決して使用しないでください。宣言型プリミティブがプレビューとレンダリングの両方で正しく処理します。 -
アセットは静的、データは動的 - 画像、フォント、オーディオファイルは
public/フォルダーに配置し、staticFile()で参照します。動的データ(APIレスポンス、データベースレコード)の場合は、delayRender()/continueRender()を使用して、データがロードされるまでレンダリングを一時停止します。
コアコンセプト
コンポジション構造
すべてのRemotionプロジェクトには、コンポジションを登録するルートファイルがあります:
import { Composition } from 'remotion';
import { MyVideo } from './MyVideo';
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
/>
);
};
フレームベースのタイミング
Remotionのすべてのタイミングは秒ではなくフレームで表現されます。変換するには:
- 秒からフレームへ:
seconds * fps - フレームから秒へ:
frame / fps
30 fpsの場合、5秒の動画は150フレームです。フレーム0が最初のフレームです。
アニメーションモデル
Remotionは2つのコアアニメーションプリミティブを提供します:
| プリミティブ | 使用例 | 例 |
|---|---|---|
interpolate() | フレームから値への線形/クランプマッピング | フェード、スライド、スケール |
spring() | 減衰/質量を持つ物理ベースのアニメーション | 弾むような出現、自然な動き |
どちらもスタイル(不透明度、transformなど)に適用する数値を返します。
一般的なタスク
1. 新しいRemotionプロジェクトのセットアップ
npx create-video@latest
これにより、TypeScript、サンプルコンポジション、Remotion Studioが設定されたプロジェクトがスキャフォールディングされます。プロジェクト構造は次のようになります:
my-video/
src/
Root.tsx # すべてのコンポジションを登録
MyComp.tsx # 最初のコンポジションコンポーネント
public/ # 静的アセット(画像、フォント、オーディオ)
remotion.config.ts # Remotion設定
package.json
プレビュースタジオを起動するには:
npx remotion studio
2. useCurrentFrameを使用した基本的なコンポジションの作成
import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate } from 'remotion';
export const FadeInText: React.FC = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: 'clamp',
});
const translateY = interpolate(frame, [0, 30], [20, 0], {
extrapolateRight: 'clamp',
});
return (
<AbsoluteFill
style={{
justifyContent: 'center',
alignItems: 'center',
backgroundColor: '#0f0f0f',
}}
>
<h1
style={{
fontSize: 80,
color: 'white',
opacity,
transform: `translateY(${translateY}px)`,
}}
>
Hello Remotion
</h1>
</AbsoluteFill>
);
};
3. 単語ごとのテキストアニメーション
テキストを単語に分割し、<Sequence>を使用して各単語の出現をずらします:
import { AbsoluteFill, Sequence, useCurrentFrame, interpolate } from 'remotion';
const AnimatedWord: React.FC<{ children: string }> = ({ children }) => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 15], [0, 1], {
extrapolateRight: 'clamp',
});
const translateY = interpolate(frame, [0, 15], [10, 0], {
extrapolateRight: 'clamp',
});
return (
<span
style={{
display: 'inline-block',
opacity,
transform: `translateY(${translateY}px)`,
marginRight: 12,
}}
>
{children}
</span>
);
};
export const WordByWord: React.FC<{ text: string }> = ({ text }) => {
const words = text.split(' ');
return (
<AbsoluteFill
style={{
justifyContent: 'center',
alignItems: 'center',
backgroundColor: '#1a1a2e',
flexWrap: 'wrap',
padding: 100,
}}
>
{words.map((word, i) => (
<Sequence key={i} from={i * 8}>
<AnimatedWord>{word}</AnimatedWord>
</Sequence>
))}
</AbsoluteFill>
);
};
4. springを使用した要素アニメーション
自然な動きを実現するためにspring()を使用します:
import { AbsoluteFill, useCurrentFrame, useVideoConfig, spring } from 'remotion';
export const SpringCard: React.FC = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const scale = spring({
frame,
fps,
config: { damping: 200, stiffness: 100, mass: 0.5 },
});
const slideUp = spring({
frame: frame - 10,
fps,
config: { damping: 12, stiffness: 100 },
});
return (
<AbsoluteFill style={{ justifyContent: 'center', alignItems: 'center', backgroundColor: '#0d1117' }}>
<div
style={{
width: 400,
height: 250,
backgroundColor: '#161b22',
borderRadius: 16,
transform: `scale(${scale}) translateY(${(1 - slideUp) * 50}px)`,
}}
>
<p style={{ color: 'white', fontSize: 32 }}>Spring Animation</p>
</div>
</AbsoluteFill>
);
};
5. SequenceとSeriesを使用したシーン遷移
重なり合うシーンには<Sequence>、順次再生には<Series>を使用します:
import { AbsoluteFill, Sequence, Series, useCurrentFrame, interpolate } from 'remotion';
const Scene: React.FC<{ color: string; title: string }> = ({ color, title }) => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 20], [0, 1], {
extrapolateRight: 'clamp',
});
return (
<AbsoluteFill style={{ backgroundColor: color, justifyContent: 'center', alignItems: 'center' }}>
<h1 style={{ color: 'white', fontSize: 72, opacity }}>{title}</h1>
</AbsoluteFill>
);
};
export const MultiScene: React.FC = () => {
return (
<AbsoluteFill>
<Series>
<Series.Sequence durationInFrames={60}>
<Scene color="#e63946" title="Scene One" />
</Series.Sequence>
<Series.Sequence durationInFrames={60}>
<Scene color="#457b9d" title="Scene Two" />
</Series.Sequence>
<Series.Sequence durationInFrames={60}>
<Scene color="#2a9d8f" title="Scene Three" />
</Series.Sequence>
</Series>
</AbsoluteFill>
);
};
6. アセットの処理(画像、フォント、staticFile)
public/フォルダーから静的アセットをstaticFile()を使用して参照します:
import { AbsoluteFill, Img, staticFile } from 'remotion';
export const AssetDemo: React.FC = () => {
return (
<AbsoluteFill style={{ justifyContent: 'center', alignItems: 'center' }}>
<Img
src={staticFile('logo.png')}
style={{ width: 300, height: 300 }}
/>
</AbsoluteFill>
);
};
カスタムフォントは@remotion/google-fontsまたはCSS @font-faceでロードします:
import { loadFont } from '@remotion/google-fonts/Inter';
const { fontFamily } = loadFont();
export const FontDemo: React.FC = () => {
return (
<AbsoluteFill style={{ justifyContent: 'center', alignItems: 'center' }}>
<h1 style={{ fontFamily, fontSize: 64, color: 'white' }}>
Custom Font
</h1>
</AbsoluteFill>
);
};
7. オーディオ統合
音量制御とタイミングを指定してオーディオを追加します:
import { AbsoluteFill, Audio, Sequence, staticFile, interpolate } from 'remotion';
export const WithAudio: React.FC = () => {
return (
<AbsoluteFill style={{ backgroundColor: '#000' }}>
<Audio
src={staticFile('background-music.mp3')}
volume={(f) =>
interpolate(f, [0, 30, 120, 150], [0, 0.8, 0.8, 0], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
})
}
/>
<Sequence from={15}>
<Audio src={staticFile('whoosh.mp3')} volume={0.5} />
</Sequence>
</AbsoluteFill>
);
};
8. 動画のレンダリング
コマンドラインからMP4にレンダリングします:
# デフォルトのコンポジションをレンダリング
npx remotion render src/index.ts MyVideo out/video.mp4
# 4K解像度でレンダリング
npx remotion render src/index.ts MyVideo out/video.mp4 --width 3840 --height 2160
# WebMにレンダリング
npx remotion render src/index.ts MyVideo out/video.webm --codec vp8
# 特定のフレーム範囲をレンダリング
npx remotion render src/index.ts MyVideo out/video.mp4 --frames 0-90
# カスタムプロップでレンダリング
npx remotion render src/index.ts MyVideo out/video.mp4 --props '{"title": "Hello"}'
プログラムによるレンダリングについては、references/rendering-guide.mdを参照してください。
アンチパターン / よくある間違い
| 間違い | なぜ間違いか | 代わりにすべきこと |
|---|---|---|
シードなしでMath.random()を使用する | レンダリング中にフレームごとに異なる出力を生成する | 決定論的なシードまたはRemotionのrandom()を使用する |
setTimeout / setIntervalを使用する | フレームベースのレンダリングが壊れる - タイマーはフレームごとに進行しない | すべてのタイミングにuseCurrentFrame()とフレーム計算を使用する |
extrapolateRight: 'clamp'の欠落 | 後続のフレームで値がターゲット範囲を超えてオーバーシュートする | interpolate()に常に{ extrapolateRight: 'clamp' }を追加する |
| フレーム計算でfpsをハードコーディングする | コンポジションのfpsが変更されたときに壊れる | タイミングの導出にuseVideoConfig().fpsを使用する |
レンダリング出力に<Video>を使用する | シークオーバーヘッドによりレンダリングパフォーマンスが低下する | より良いレンダリングパフォーマンスのために<OffthreadVideo>を使用する |
非同期データにdelayRender()を忘れる | データがロードされる前にレンダリングが行われ、空のフレームや壊れたフレームが表示される | すぐにdelayRender()を呼び出し、準備ができたらcontinueRender()を呼び出す |
| 非決定論的な値を持つインラインスタイル | プレビューとレンダリングの間でちらつきや不整合が発生する | すべてのスタイル値をフレーム番号からのみ導出する |
| 巨大な単一コンポジション | メンテナンスが困難で、シーンを個別にレンダリングできない | 複数のコンポジションに分割するか、シーンにSeriesを使用する |
注意点
-
extrapolateRightのデフォルトは'extend' - クランプなしで
interpolate(frame, [0, 30], [0, 1])と書くと、フレーム30を超えると値は1を超えて増加し続けます(例:フレーム60で不透明度2)。意図的に外挿したい場合を除き、常に{ extrapolateRight: 'clamp' }を渡してください。 -
spring()はそのコンテキストのフレーム0から開始する -
<Sequence from={60}>内でspring()を使用する場合、springに渡されるフレームは親のフレーム60で0にリセットされます。親の生のフレームを渡すと、アニメーションはすでに完了しています。親からのフレームではなく、Sequenceの子内でuseCurrentFrame()を使用してください。 -
staticFile()パスはpublic/からの相対パス -
staticFile('images/logo.png')を呼び出すと、public/images/logo.pngを探します。絶対パスまたはpublic/外のパスを使用すると、プレビューで静かに失敗し、レンダリング中にエラーになります。すべてのアセットがpublic/ディレクトリにあることを確認してください。 -
delayRenderには30秒のタイムアウトがある - 非同期操作(API呼び出し、フォントロード)に30秒以上かかる場合、レンダリングは中断されます。低速操作の場合は、
delayRender('Loading data', { timeoutInMilliseconds: 60000 })でタイムアウトを増やしてください。 -
コンポジションの寸法は偶数でなければならない - ビデオコーデック(H.264、VP8)には偶数幅と高さが必要です。Remotionは、奇数の寸法のコンポジションをレンダリングしようとするとエラーをスローします。常に偶数値を使用してください。
-
useVideoConfigはコンポーネント内でのみ利用可能 - コンポジション設定(fps、幅、高さ)をコンポーネントツリー外で必要とする場合(カスタムフックやユーティリティ)、それらをpropsとして渡すか、コンポーネント内の
useVideoConfig()から導出してください。最上位のモジュールスコープでは利用できません。
サンプル構成
以下のコンポジションは利用可能です:
SchemaExample- Zodスキーマを使用したパラメータ化された動画をデモします。ソースコードを参照してください。HelloWorld- Remotionの基本的な使用法を示すサンプルコンポジション。このファイルReadme.mdの冒頭にあるもの。Animated- アニメーションの例。Tailwind- Tailwind CSSの例。
詳細情報
Remotionの詳細については、remotion.devをご覧ください。
ライセンス
このスキルはMITライセンスの下で提供されます。