これは Remotion React マークアップを作成するためのガイダンスです。 これが該当しない場合は、代わりに Remotion のベストプラクティスを読み込んでください。
ユーザーの変更を保持する
ユーザーは会話の外でコードを編集することがあります。
その間に予期しない変更を検出した場合は、上書きせず、意図的なものと見なすか、確認を求めてください。
一般的なルール
コンポジションまたはシーンコンポーネント内では、useVideoConfig() から fps を取得して、すべての秒数からフレームへの計算を行います。これには、from、trimBefore、durationInFrames、premountFor などのタイミングプロパティが含まれます。trimBefore={4 * fps} のように式を JSX ノードに直接記述することで、Studio でタイミングを編集でき、コンポジションのフレームレートが変更された場合も正しい状態を保てます。
アニメーションは useCurrentFrame() と interpolate() を使用して駆動します。
CSS の transition や animation は正しくレンダリングされないため、リファクタリングする必要があります。
Tailwind のアニメーションクラスも正しくレンダリングされないため、リファクタリングする必要があります。
タイミングをカスタマイズするには Easing.bezier() と Easing.spring() を使用します。
Remotion のインタラクティブベストプラクティスに従ってマークアップを構成します。
カスタムビジュアルコンポーネントで編集可能なプロパティを備えたものには、Interactive.withSchema({wrapInSequence: true}) を優先して使用し、再利用可能なシーンは接続コンポジションとして登録します。
タイミングは、それをサポートするコンポーネントに直接設定します。冗長な <Sequence> ラッパーは避けてください。
premountFor をサポートするすべてのタイミングコンポーネントに、1 秒間のプリマウントを設定します。premountFor={fps}(fps は useVideoConfig() から取得)。これをメディア、インタラクティブコンポーネント、<Sequence>、<Series.Sequence>、<TransitionSeries.Sequence>、<TransitionSeries.Overlay> に適用します。シーン内にネストされたタイミングコンポーネントも含みます。ネストされたアイテムが親の開始前にマウントする必要がある場合は、親のタイムラインアイテムもプリマウントします。premountFor がないコンポーネント(<TransitionSeries.Transition> など)は、代わりを必要としません。
Studio は、アイテムを作成した JSX ソースノードを編集します。すべてのコンポジション登録、クリップ、シーン、レイヤー、シーケンスは、独立した JSX ノードとして、編集可能なプロパティをインラインで記述します。 プログラムによるループは、生成されたインスタンスを意図的に 1 つのソーステンプレートとして制御する場合に適しています。ユーザーがインスタンスを個別に編集する必要がある場合には適していません。
import { useCurrentFrame, useVideoConfig, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const {fps} = useVideoConfig();
return (
<Interactive.Div
name="Title"
premountFor={fps}
style={{
opacity: interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Hello World!
</Interactive.Div>
);
};
interpolate() の呼び出しは style プロパティ内にインラインで記述します。
transform の代わりに scale、translate、rotate の CSS プロパティを使用します。
// 👍 インラインで編集可能なキーフレームとトランスフォームのショートハンド
style={{
scale: interpolate(frame, [0, 100], [0, 1], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
output: 'perceptual-scale' // `scale` アニメーションの場合は "output: 'perceptual-scale'" を使用
}),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.spring({damping: 200}),
}),
}}
// 👎 インラインでない値と transform 文字列は Studio で編集が難しくなる
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
アセット
アセットはプロジェクトルートの public/ フォルダに配置します。
public/ フォルダ内のファイルを参照するには staticFile() を使用します。
メディアコンポーネント
ビデオとオーディオは @remotion/media の <Video> と <Audio> を使用して追加します。
画像は <CanvasImage> コンポーネントを使用して追加します。
アニメーション GIF、APNG、WebP、AVIF 画像は <AnimatedImage> を使用します。Chrome 以外の場合は @remotion/gif を使用します。
public/ 内のファイルには staticFile() を使用するか、リモート URL を直接渡します。
import { Audio, Video } from "@remotion/media";
import { staticFile, CanvasImage, AnimatedImage, useVideoConfig } from "remotion";
export const MyComposition = () => {
const {fps} = useVideoConfig();
return (
<>
<Video src={staticFile("video.mp4")} premountFor={fps} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} premountFor={fps} />
<CanvasImage
src={staticFile("logo.png")}
premountFor={fps}
style={{ width: 100, height: 100 }}
/>
<Video src="https://remotion.media/video.mp4" premountFor={fps} />
<AnimatedImage src={staticFile('nyancat.gif')} premountFor={fps} />
</>
);
};
コンポジションが主にビデオまたはオーディオクリップのタイムラインである場合は、ソース構造を選択する前に video-editing.md を読んでください。
シーンの例
背景ビデオとローワーサード。
ローワーサードは独自のタイムラインを持つインタラクティブコンポーネントで、接続コンポジションとして登録されています。
そのテキストは children として渡され、accentColor は編集可能なプロパティです。
フェードインは呼び出し元でインラインにキーフレーム設定されています。
// MyScene.tsx
import { Video } from "@remotion/media";
import { Easing, interpolate, useCurrentFrame, useVideoConfig } from "remotion";
import { LowerThird } from "./LowerThird";
export const MyScene = () => {
const { fps } = useVideoConfig();
const frame = useCurrentFrame();
return (
<>
<Video
name="Background"
src="https://remotion.media/video.mp4"
premountFor={fps}
objectFit="cover"
style={{
position: "absolute",
width: "100%",
height: "100%",
}}
/>
<LowerThird
name="Lower third"
from={1 * fps}
premountFor={fps}
accentColor="#0b84f3"
style={{
opacity: interpolate(frame, [1 * fps, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Jane Doe, Product Designer
</LowerThird>
</>
);
};
// LowerThird.tsx
import type React from "react";
import { Interactive, type InteractivitySchema } from "remotion";
type LowerThirdProps = {
readonly children: string;
readonly accentColor: string;
readonly style?: React.CSSProperties;
};
const LowerThirdInner: React.FC<LowerThirdProps> = ({
children,
accentColor,
style,
}) => {
return (
<Interactive.Div
style={{
position: "absolute",
left: 80,
bottom: 80,
display: "flex",
alignItems: "center",
gap: 20,
backgroundColor: "white",
borderRadius: 16,
padding: "20px 32px",
color: "black",
fontFamily: "Helvetica, Arial, sans-serif",
fontSize: 48,
fontWeight: 600,
...style,
}}
>
<div
style={{
width: 8,
alignSelf: "stretch",
borderRadius: 4,
backgroundColor: accentColor,
}}
/>
{children}
</Interactive.Div>
);
};
const lowerThirdSchema = {
children: { type: "text-content", default: "", description: "Text" },
accentColor: {
type: "color",
default: "#0b84f3",
description: "Accent color",
},
} as const satisfies InteractivitySchema;
export const LowerThird = Interactive.withSchema({
Component: LowerThirdInner,
componentName: "<LowerThird>",
schema: lowerThirdSchema,
wrapInSequence: true,
});
// Root.tsx
import { Composition } from "remotion";
import { LowerThird } from "./LowerThird";
import { MyScene } from "./MyScene";
export const RemotionRoot: React.FC = () => {
return (
<>
<Composition
id="MyScene"
component={MyScene}
durationInFrames={60}
fps={30}
width={1280}
height={720}
/>
<Composition
id="LowerThird"
component={LowerThird}
durationInFrames={30}
fps={30}
width={1280}
height={720}
defaultProps={{
children: "Jane Doe, Product Designer",
accentColor: "#0b84f3",
}}
/>
</>
);
};
遅延、トリミング
タイミングはそれをサポートするコンポーネントに直接設定します。サポートされているプロパティ、例、および操作の順序については、タイミングプロパティを参照してください。
マップ
ビデオにマップを含めたい場合は、Remotion Maps を参照してください。
テキストハイライトと注釈
テキストハイライト(ハイライトマーカー)、円、下線、取り消し線、取り消しテキスト、ボックスについては、text-highlights.md を参照してください。
マルチシーンビデオ
複数の連続するシーンでビデオを作成する予定がある場合は、multi-scene-video.md を参照してください。
接続コンポジション
シーンまたはレイヤーのグループに独自の編集可能なタイムラインが必要な場合は、connected-compositions.md に従ってください。マルチシーンビデオの重要なシーンには、この構造を優先してください。
プリコンポーズアクション
Pre-compose Ambient glow (src/BarChart.tsx:134) などの Studio リクエストの場合、指定された場所にある選択されたシーケンスマークアップを見つけます。connected-compositions.md に従って接続コンポジションを作成します。マークアップを名前付きコンポーネントに抽出し、できれば Interactive.withSchema({wrapInSequence: true}) を使用してインタラクティブにし、同じエクスポートされたコンポーネント参照をルート内の一意の <Composition> に登録します。インタラクティブコンポーネントをそのタイミングプロパティとともに直接レンダリングするか、ラッパーに意味がある場合はシーケンスの唯一の子としてレンダリングします。選択されたノードがすでにシーケンスである場合は、そのプロパティを保持し、その子を抽出します。登録には、親の使用と同等のディメンション、fps、duration、および defaultProps が必要です。登録されたコンポジションがないコンポーネントの抽出では、プリコンポーズリクエストは完了しません。
抽出されたコンポーネントに、fontFamily やフォント読み込みなどの継承されたスタイルを引き継ぎます。親からの独立性を参照してください。
ボイスオーバー
ElevenLabs TTS を使用して Remotion コンポジションに AI 生成のボイスオーバーを追加するには、voiceover.md を参照してください。
ビデオの埋め込み
ビデオの埋め込みに関する高度な知識(トリミング、音量、速度、ループ、ピッチ)については、embedding-videos.md を参照してください。
オーディオの埋め込み
トリミング、音量、速度、ピッチなどの高度なオーディオ機能については、audio.md を参照してください。
クロッピング
コンポーネントの可視領域を切り抜く必要がある場合は、cropping.md を参照してください。
トランジション
シーン遷移パターンについては、transitions.md を参照してください。
モーションブラー
モーションブラーまたは移動軌跡を追加する場合は、推奨される HTML-in-canvas アプローチ、プレビューの要件、および代替案について motion-blur.md を読んでください。
ビジュアルおよびピクセルエフェクト
視覚効果を作成する場合は、CSS と HTML を使用して実現可能か、またはシェーダーが必要かを検討してください。 優先順位は次のとおりです。
- 通常の HTML + CSS またはその他の Web 技術
- 要素に直接適用するエフェクト(
<Video>、<Img>)、またはコンテンツを<HtmlInCanvas>でラップするエフェクト。これもeffectsを受け入れます。
- effects.md によるリスト化されたエフェクト
- プリセットがない場合は、effects.md によるカスタム
createEffect()
3D コンテンツ
Three.js と React Three Fiber を使用した Remotion での 3D コンテンツについては、./3d.md を参照してください。
サウンドエフェクト
サウンドエフェクトを使用する必要がある場合は、./sfx.md ファイルを読み込んで詳細を確認してください。
オーディオビジュアライゼーション
オーディオを視覚化する必要がある場合(スペクトラムバー、波形、低音反応エフェクト)、詳細については ./audio-visualization.md ファイルを読み込んでください。
マップ
静的マップ、アニメーションルートとマーカー、地理解説、Mapbox、MapLibre、MapTiler、GeoJSON、または 3D 地理フライオーバーについては、Remotion Maps を読み込んでください。
キャプション
キャプションまたは字幕を扱う場合は、詳細について Remotion Captions スキルを読み込んでください。
Google Fonts
Remotion でフォントを読み込む推奨方法です。Google Fonts の読み込み方法については、google-fonts.md を参照してください。
ローカルフォント
ローカルフォントの読み込み方法については、local-fonts.md を参照してください。
GIF
Remotion のタイムラインに同期して GIF を表示する方法については、gifs.md を参照してください。
高度な画像
画像のサイズ変更と配置、動的な画像パス、画像サイズの取得については、images.md を参照してください。
Lottie アニメーション
Remotion に Lottie アニメーションを埋め込む方法については、lottie.md を参照してください。
タイミング
interpolate() のタイミングテクニックの詳細については、timing.md を参照してください。
パラメータ化されたビデオ
Zod スキーマを追加してコンポジションをパラメータ化可能にする方法については、parameters.md を参照してください。
DOM ノードの測定
Remotion で DOM 要素の寸法を測定する方法については、measuring-dom-nodes.md を参照してください。
テキストの測定
テキストサイズの測定、コンテナへのテキストの適合、オーバーフローの確認については、measuring-text.md を参照してください。
FFmpeg の使用
ビデオのトリミングや無音部分の検出など、一部のビデオ操作では FFmpeg を使用する必要があります。詳細については、./ffmpeg.md ファイルを読み込んでください。
無音部分の検出
ビデオまたはオーディオファイルから無音部分を検出してトリミングする必要がある場合は、./silence-detection.md ファイルを読み込んでください。
動的な duration、ディメンション、データ
コンポジションの duration、ディメンション、または入力データを動的に設定する方法については、calculate-metadata.md を参照してください。