使用するタイミング
Remotion のコードを扱う際には、このスキルを使用してドメイン固有の知識を取得してください。
新規プロジェクトのセットアップ
空のフォルダや既存の Remotion プロジェクトがないワークスペースで、以下のコマンドでプロジェクトをスキャフォールディングします。
npx create-video@latest --yes --blank --no-tailwind my-video
my-video を適切なプロジェクト名に置き換えてください。
動画のデザイン
ビジュアルシーン、レイアウト、プロモーション、モーショングラフィックス、テキストの多い動画をデザインする前に、rules/video-layout.md を読み込んで、動画ファーストのレイアウトとテキストサイズのガイダンスを参照してください。
useCurrentFrame() と interpolate() を使用してプロパティをアニメーションさせます。物理ベースのモーションが明示的に必要な場合を除き、spring() よりも interpolate() を優先してください。Easing.bezier() を使用して、跳ねるような動きやオーバーシュートする動きなど、タイミングをカスタマイズします。
Remotion Studio で編集可能なアニメーションにするには、interpolate() の呼び出しを style プロパティにインラインで記述し、transform 文字列を構成する代わりに、個別の CSS 変換プロパティ(scale、translate、rotate)を使用します。
import { useCurrentFrame, Easing, interpolate, useVideoConfig } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Hello World!</div>;
};
以下を推奨します:
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
以下は避けてください:
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
CSS トランジションやアニメーションは禁止です。正しくレンダリングされません。 Tailwind のアニメーションクラス名も禁止です。正しくレンダリングされません。
アセットはプロジェクトルートの public/ フォルダに配置します。
staticFile() を使用して public/ フォルダのファイルを参照します。
画像を追加するには <Img> コンポーネントを使用します:
import { Img, staticFile } from "remotion";
export const MyComposition = () => {
return <Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />;
};
動画を追加するには @remotion/media の <Video> コンポーネントを使用します:
import { Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />;
};
音声を追加するには @remotion/media の <Audio> コンポーネントを使用します:
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return <Audio src={staticFile("audio.mp3")} />;
};
アセットはリモート URL として参照することもできます:
import { Video } from "@remotion/media";
export const MyComposition = () => {
return <Video src="https://remotion.media/video.mp4" />
};
コンテンツを遅延させるには、<Sequence> でラップし、from を使用します。
要素の持続時間を制限するには、<Sequence> の durationInFrames を使用します。
<Sequence> はデフォルトで絶対フィル(absolute fill)になります。インラインコンテンツの場合は、layout="none" を使用します。
import { Sequence } from "remotion";
export const Title = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return <div style={{ opacity }}>Title</div>;
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence>
<Background />
</Sequence>
<Sequence from={1 * fps} durationInFrames={2 * fps} layout="none">
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
動画の幅、高さ、fps、および持続時間は src/Root.tsx で定義します:
import { Composition } from "remotion";
import { MyComposition } from "./MyComposition";
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
durationInFrames={100}
fps={30}
width={1080}
height={1080}
/>
);
};
メタデータは動的に計算することもできます:
import { Composition, CalculateMetadataFunction } from "remotion";
import { MyComposition, MyCompositionProps } from "./MyComposition";
const calculateMetadata: CalculateMetadataFunction<
MyCompositionProps
> = async ({ props, abortSignal }) => {
const data = await fetch(`https://api.example.com/video/${props.videoId}`, {
signal: abortSignal,
}).then((res) => res.json());
return {
durationInFrames: Math.ceil(data.duration * 30),
props: {
...props,
videoUrl: data.url,
},
width: 1080,
height: 1080,
};
};
export const RemotionRoot = () => {
return (
<Composition
id="MyComposition"
component={MyComposition}
fps={30}
width={1080}
height={1080}
defaultProps={{ videoId: "abc123" }}
calculateMetadata={calculateMetadata}
/>
);
};
プレビューの開始
Remotion Studio を起動して動画をプレビューします:
npx remotion studio
オプション: 1フレームレンダリングチェック
CLI を使用して1フレームをレンダリングし、レイアウト、色、タイミングを簡単に確認できます。 些細な編集、純粋なリファクタリング、または Studio や以前のレンダリングで十分な確信が得られている場合はスキップしてください。
npx remotion still [composition-id] --scale=0.25 --frame=30
30 fps の場合、--frame=30 は1秒のマークです(--frame はゼロベースです)。
キャプション
キャプションや字幕を扱う場合は、./rules/subtitles.md ファイルを読み込んで詳細を確認してください。
FFmpeg の使用
動画のトリミングや無音検出など、一部の動画操作では FFmpeg を使用する必要があります。./rules/ffmpeg.md ファイルを読み込んで詳細を確認してください。
無音検出
動画や音声ファイルから無音部分を検出してトリミングする必要がある場合は、./rules/silence-detection.md ファイルを読み込んでください。
音声の可視化
音声を可視化する必要がある場合(スペクトラムバー、波形、低音反応エフェクトなど)、./rules/audio-visualization.md ファイルを読み込んで詳細を確認してください。
サウンドエフェクト
サウンドエフェクトを使用する必要がある場合は、./rules/sfx.md ファイルを読み込んで詳細を確認してください。
ビジュアルエフェクトとピクセルエフェクト
視覚効果を作成する場合は、以下の優先順位に従ってください:1. 通常の Remotion/HTML/CSS/SVG/フィルター/ブレンド/マスクアニメーション、2. rules/effects.md にリストされているエフェクト(<HtmlInCanvas> を通じてレンダリングされる HTML 上も含む)、3. 再利用可能/プロジェクト固有のエフェクトが必要な場合は、rules/effects.md を介したカスタム createEffect()、4. どのエフェクトも合わない場合のみ、rules/html-in-canvas.md を介したカスタム <HtmlInCanvas onPaint>。
ライトリークオーバーレイについては、rules/light-leaks.md を参照してください。ドキュメント:https://www.remotion.dev/docs/effects
利用可能なエフェクト:brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), thermalVision(), blur(), linearProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst()。
3D コンテンツ
Remotion で Three.js と React Three Fiber を使用した 3D コンテンツについては、rules/3d.md を参照してください。
高度な音声
トリミング、音量、速度、ピッチなどの高度な音声機能については、rules/audio.md を参照してください。
動的な持続時間、サイズ、データ
コンポジションの持続時間、寸法、プロパティを動的に設定するには、rules/calculate-metadata.md を参照してください。
高度なコンポジション
静止画、フォルダ、デフォルトプロパティの定義方法、およびコンポジションのネスト方法については、rules/compositions.md を参照してください。
Google Fonts
Remotion でフォントを読み込む推奨方法です。rules/google-fonts.md を参照して、Google Fonts の読み込み方法を確認してください。
ローカルフォント
ローカルフォントの読み込み方法については、rules/local-fonts.md を参照してください。
音声の長さの取得
Mediabunny を使用して音声ファイルの長さ(秒)を取得する方法については、rules/get-audio-duration.md を参照してください。
動画のサイズ取得
Mediabunny を使用して動画ファイルの幅と高さを取得する方法については、rules/get-video-dimensions.md を参照してください。
動画の長さの取得
Mediabunny を使用して動画ファイルの長さ(秒)を取得する方法については、rules/get-video-duration.md を参照してください。
GIF
Remotion のタイムラインと同期して GIF を表示する方法については、rules/gifs.md を参照してください。
高度な画像
画像のサイズ設定と配置、動的な画像パス、画像サイズの取得については、rules/images.md を参照してください。
Lottie アニメーション
Remotion に Lottie アニメーションを埋め込む方法については、rules/lottie.md を参照してください。
DOM ノードの測定
Remotion で DOM 要素のサイズを測定する方法については、rules/measuring-dom-nodes.md を参照してください。
テキストの測定
テキストのサイズ測定、コンテナへのテキストのフィッティング、オーバーフローの確認については、rules/measuring-text.md を参照してください。
高度なシーケンス
遅延、トリミング、アイテムの持続時間制限など、より高度なシーケンスパターンについては、rules/sequencing.md を参照してください。
TailwindCSS
Remotion で TailwindCSS を使用する方法については、rules/tailwind.md を参照してください。
テキストアニメーション
タイポグラフィとテキストアニメーションパターンについては、rules/text-animations.md を参照してください。
高度なタイミング
interpolate とベジェイージング、スプリングを使用した高度なタイミングについては、rules/timing.md を参照してください。
トランジション
シーントランジションパターンについては、rules/transitions.md を参照してください。
透明な動画
透明度のある動画をレンダリングする方法については、rules/transparent-videos.md を参照してください。
トリミング
トリミングパターン(アニメーションの先頭または末尾をカット)については、rules/trimming.md を参照してください。
高度な動画
動画の埋め込み(トリミング、音量、速度、ループ、ピッチ)に関する高度な知識については、rules/videos.md を参照してください。
パラメータ化された動画
Zod スキーマを追加してコンポジションをパラメータ化可能にする方法については、rules/parameters.md を参照してください。
地図
シンプルなフライオーバーの少ない地図には、静的な地図画像の使用を検討してください。 アニメーションルートやフライオーバーがある複雑な地図については、地図ルールを読み込んでください:rules/maplibre.md。
ボイスオーバー
ElevenLabs TTS を使用して Remotion コンポジションに AI 生成のボイスオーバーを追加する方法については、rules/voiceover.md を参照してください。