使用するタイミング
このスキルは、Remotionのコードを扱う際にドメイン固有の知識を得るために使用してください。
新規プロジェクトのセットアップ
空のフォルダまたはRemotionプロジェクトが存在しないワークスペースで、以下のコマンドを使用して新しいプロジェクトを作成します。
npx create-video@latest --yes --blank --no-tailwind my-video
my-video は適切なプロジェクト名に置き換えてください。
動画の設計
useCurrentFrame() と interpolate() を使ってプロパティをアニメーションさせます。アニメーションのタイミングをカスタマイズするにはEasingを使用します。
import { useCurrentFrame, Easing } 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>;
};
CSSトランジションやアニメーションは禁止です。正しくレンダリングされません。 Tailwindのアニメーションクラス名も禁止です。正しくレンダリングされません。
アセットはプロジェクトルートの public/ フォルダに配置してください。
public/ フォルダ内のファイルを参照するには staticFile() を使用します。
画像は <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で単一フレームをレンダリングして、レイアウト、色、タイミングを簡単に確認できます。 些細な編集や純粋なリファクタリング、Studioや以前のレンダリングで十分な確信がある場合はスキップしてください。
npx remotion still [composition-id] --scale=0.25 --frame=30
30fpsの場合、--frame=30 は1秒の位置を示します(--frame は0基準です)。
キャプション(字幕)
キャプションや字幕を扱う場合は、./rules/subtitles.md ファイルを読み込んで詳細を確認してください。
FFmpegの使用
動画のトリミングや無音検出など、一部の動画操作にはFFmpegを使用します。./rules/ffmpeg.md ファイルを読み込んで詳細を確認してください。
無音検出
動画や音声ファイルから無音部分を検出してトリミングする必要がある場合は、./rules/silence-detection.md ファイルを読み込んでください。
音声の可視化
音声を可視化(スペクトラムバー、波形、低音反応エフェクトなど)する必要がある場合は、./rules/audio-visualization.md ファイルを読み込んで詳細を確認してください。
効果音
効果音を使用する必要がある場合は、./rules/sfx.md ファイルを読み込んで詳細を確認してください。
3Dコンテンツ
Three.jsとReact Three Fiberを使用したRemotionの3Dコンテンツについては、rules/3d.md を参照してください。
高度な音声
トリミング、音量、速度、ピッチなどの高度な音声機能については、rules/audio.md を参照してください。
動的な長さ、サイズ、データ
コンポジションの長さ、サイズ、プロパティを動的に設定する方法については、rules/calculate-metadata.md を参照してください。
高度なコンポジション
スチル、フォルダ、デフォルトプロパティの定義方法、およびコンポジションのネスト方法については、rules/compositions.md を参照してください。
Google Fonts
Remotionでフォントを読み込む推奨方法です。Google Fontsの読み込み方法については、rules/google-fonts.md を参照してください。
ローカルフォント
ローカルフォントの読み込み方法については、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 を参照してください。
ライトリーク
@remotion/light-leaks を使用したライトリークオーバーレイエフェクトについては、rules/light-leaks.md を参照してください。
Lottieアニメーション
RemotionにLottieアニメーションを埋め込む方法については、rules/lottie.md を参照してください。
キャンバス内のHTML
2DまたはWebGLエフェクトを適用するために、HTMLを <canvas> にレンダリングする必要がある場合は、rules/html-in-canvas.md を参照してください(<HtmlInCanvas> を使用)。
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を使用してAI生成のナレーションをRemotionコンポジションに追加する方法については、rules/voiceover.md を参照してください。