Remotion -- React로 비디오 만들기
이 스킬은 Remotion 코드 작업 시 사용하세요. Remotion을 사용하면 React 컴포넌트로 프로그래매틱 방식의 비디오를 만들 수 있습니다.
프로젝트 설정
npx create-video@latest my-video
cd my-video
npm start # 브라우저에서 미리보기
npm run render # MP4로 렌더링
컴포지션
<Composition>은 크기, FPS, 지속 시간을 가진 렌더링 가능한 비디오를 정의합니다.
import { Composition } from "remotion";
import { MyVideo } from "./MyVideo";
export const RemotionRoot = () => (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={300}
fps={30}
width={1920}
height={1080}
defaultProps={{ title: "Hello World" } satisfies MyVideoProps}
/>
);
defaultProps 타입 안전성을 위해 interface 대신 type 선언을 사용하세요.
사이드바에서 컴포지션을 구성하려면 <Folder>를 사용하세요. 단일 프레임 출력(썸네일, OG 이미지)에는 <Still>을 사용하세요.
애니메이션
모든 애니메이션은 반드시 useCurrentFrame()을 사용해야 합니다. CSS 전환과 Tailwind 애니메이션 클래스는 금지됩니다. 올바르게 렌더링되지 않습니다.
import { useCurrentFrame, useVideoConfig, interpolate } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, 2 * fps], [0, 1], {
extrapolateRight: "clamp",
});
return <div style={{ opacity }}>Hello World!</div>;
};
스프링 애니메이션
스프링은 자연스러운 움직임을 제공합니다. 0에서 1로 애니메이션됩니다.
import { spring, useCurrentFrame, useVideoConfig } from "remotion";
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const scale = spring({ frame, fps });
// 설정 포함:
const smooth = spring({ frame, fps, config: { damping: 200 } }); // 튕김 없음
const snappy = spring({ frame, fps, config: { damping: 20, stiffness: 200 } });
const bouncy = spring({ frame, fps, config: { damping: 8 } });
const heavy = spring({ frame, fps, config: { damping: 15, stiffness: 80, mass: 2 } });
delay 매개변수를 사용하여 스프링 시작을 지연시킵니다:
const entrance = spring({ frame, fps, delay: 20 });
보간
// 선형 보간 및 클램핑
const opacity = interpolate(frame, [0, 100], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
});
// 다중 단계 보간
const y = interpolate(frame, [0, 30, 60, 90], [100, 0, 0, -100]);
시퀀싱
Sequence
<Sequence>를 사용하여 요소가 나타나는 시점을 지연시킵니다. 구성 요소를 미리 로드하려면 항상 premountFor를 사용하세요.
import { Sequence } from "remotion";
const { fps } = useVideoConfig();
<Sequence from={1 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
<Title />
</Sequence>
<Sequence from={2 * fps} durationInFrames={2 * fps} premountFor={1 * fps}>
<Subtitle />
</Sequence>
절대 위치 지정 래퍼를 방지하려면 layout="none"을 사용하세요.
Series
겹침 없이 순차 재생을 위해 <Series>를 사용하세요:
import { Series } from "remotion";
<Series>
<Series.Sequence durationInFrames={45}><Intro /></Series.Sequence>
<Series.Sequence durationInFrames={60}><MainContent /></Series.Sequence>
<Series.Sequence durationInFrames={30}><Outro /></Series.Sequence>
</Series>
음수 offset은 겹치는 전환을 만듭니다:
<Series.Sequence offset={-15} durationInFrames={60}>
<SceneB />
</Series.Sequence>
전환
npx remotion add @remotion/transitions
import { TransitionSeries, linearTiming } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
import { wipe } from "@remotion/transitions/wipe";
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={60}>
<SceneA />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={fade()}
timing={linearTiming({ durationInFrames: 15 })}
/>
<TransitionSeries.Sequence durationInFrames={60}>
<SceneB />
</TransitionSeries.Sequence>
</TransitionSeries>
라이트 릭 오버레이
import { LightLeak } from "@remotion/light-leaks";
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={60}>
<SceneA />
</TransitionSeries.Sequence>
<TransitionSeries.Overlay durationInFrames={20}>
<LightLeak />
</TransitionSeries.Overlay>
<TransitionSeries.Sequence durationInFrames={60}>
<SceneB />
</TransitionSeries.Sequence>
</TransitionSeries>
오버레이는 전환 또는 다른 오버레이와 인접할 수 없습니다.
오디오
npx remotion add @remotion/media
import { Audio } from "@remotion/media";
import { staticFile } from "remotion";
// 기본 오디오
<Audio src={staticFile("audio.mp3")} />
// 트리밍 (값은 프레임 단위)
<Audio src={staticFile("audio.mp3")} trimBefore={2 * fps} trimAfter={10 * fps} />
// 볼륨 제어
<Audio src={staticFile("audio.mp3")} volume={0.5} />
// 동적 볼륨 (콜백은 프레임을 받음)
<Audio src={staticFile("audio.mp3")} volume={(f) =>
interpolate(f, [0, 30], [0, 1], { extrapolateRight: "clamp" })
} />
// 속도 변경
<Audio src={staticFile("audio.mp3")} playbackRate={1.5} />
// 오디오 시작 지연
<Sequence from={1 * fps}>
<Audio src={staticFile("audio.mp3")} />
</Sequence>
여러 개의 <Audio> 구성 요소는 자동으로 레이어링됩니다.
비디오 임베딩
import { Video } from "@remotion/media";
// 기본 비디오
<Video src={staticFile("video.mp4")} />
// 트리밍 포함
<Video src={staticFile("video.mp4")} trimBefore={2 * fps} trimAfter={10 * fps} />
// 속도, 볼륨, 반복
<Video src={staticFile("video.mp4")} playbackRate={2} volume={0.5} loop />
// 렌더링 성능을 위해 OffthreadVideo 사용
import { OffthreadVideo } from "remotion";
<OffthreadVideo src={staticFile("video.mp4")} />
렌더링 성능을 위해 항상 <OffthreadVideo>를 사용하세요. <Video>는 미리보기 중에만 사용하세요.
ElevenLabs TTS를 사용한 음성 해설
씬별로 음성을 생성한 다음 calculateMetadata를 사용하여 컴포지션의 크기를 동적으로 조정합니다.
오디오 생성
const response = await fetch(
`https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`,
{
method: "POST",
headers: {
"xi-api-key": process.env.ELEVENLABS_API_KEY!,
"Content-Type": "application/json",
Accept: "audio/mpeg",
},
body: JSON.stringify({
text: "어서 오세요.",
model_id: "eleven_multilingual_v2",
voice_settings: { stability: 0.5, similarity_boost: 0.75, style: 0.3 },
}),
},
);
const audioBuffer = Buffer.from(await response.arrayBuffer());
writeFileSync(`public/voiceover/scene-01.mp3`, audioBuffer);
동적 지속 시간
import { CalculateMetadataFunction, staticFile } from "remotion";
const FPS = 30;
const SCENES = ["voiceover/scene-01.mp3", "voiceover/scene-02.mp3"];
export const calculateMetadata: CalculateMetadataFunction<Props> = async () => {
const durations = await Promise.all(
SCENES.map((file) => getAudioDuration(staticFile(file)))
);
const totalFrames = durations.reduce((sum, d) => sum + Math.ceil(d * FPS), 0);
return { durationInFrames: totalFrames };
};
자산
파일을 public/에 배치하고 staticFile()로 참조합니다:
import { staticFile, Img } from "remotion";
<Img src={staticFile("logo.png")} />
미디어 파일에 절대 require() 또는 import를 사용하지 마세요. 항상 staticFile()을 사용하세요.
글꼴
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// 또는 로컬 글꼴
const { fontFamily } = loadFont({
url: staticFile("fonts/MyFont.woff2"),
display: "swap",
});
Remotion에서 FFmpeg
FFmpeg는 번들로 제공되며 별도 설치가 필요 없습니다:
bunx remotion ffmpeg -i input.mp4 output.mp3
bunx remotion ffprobe input.mp4
트리밍의 경우 FFmpeg보다는 trimBefore/trimAfter props를 선호합니다. 형식 변환 또는 Remotion이 기본적으로 할 수 없는 작업에는 FFmpeg를 사용하세요.
FFmpeg를 사용하여 트리밍할 때는 프레임이 정지되는 것을 방지하기 위해 반드시 다시 인코딩해야 합니다:
bunx remotion ffmpeg -ss 00:00:05 -i public/input.mp4 -to 00:00:10 -c:v libx264 -c:a aac public/output.mp4
렌더링
# 특정 컴포지션 렌더링
npx remotion render MyVideo output.mp4
# 스틸 프레임 렌더링
npx remotion still MyVideo --frame=100 thumbnail.png
# 사용자 지정 props 사용
npx remotion render MyVideo output.mp4 --props='{"title": "Custom"}'
# 특정 코덱
npx remotion render MyVideo output.webm --codec=vp8
일반적인 패턴
씬 기반 비디오
const SCENES = [
{ component: TitleScene, duration: 90 },
{ component: ProblemScene, duration: 150 },
{ component: SolutionScene, duration: 120 },
{ component: CTAScene, duration: 90 },
];
export const MyVideo = () => {
let offset = 0;
return (
<>
{SCENES.map(({ component: Component, duration }, i) => {
const from = offset;
offset += duration;
return (
<Sequence key={i} from={from} durationInFrames={duration}>
<Component />
</Sequence>
);
})}
</>
);
};
배경 음악 + 음성 해설
<>
{/* 배경 음악 (낮은 볼륨) */}
<Audio src={staticFile("music/bg.mp3")} volume={0.12} loop />
{/* 씬 음성 해설 (전체 볼륨) */}
<Sequence from={0} durationInFrames={scene1Frames}>
<Audio src={staticFile("voiceover/scene-01.mp3")} volume={1} />
</Sequence>
<Sequence from={scene1Frames} durationInFrames={scene2Frames}>
<Audio src={staticFile("voiceover/scene-02.mp3")} volume={1} />
</Sequence>
</>
주요 규칙
- CSS 애니메이션 금지 -- 모든 움직임은
useCurrentFrame()+interpolate()/spring()사용 - Tailwind 애니메이션 클래스 금지 -- 올바르게 렌더링되지 않음
- 자산은 항상
staticFile()--require()사용 금지 - Sequence는 항상
premountFor로 미리 마운트 - 렌더링에는
<OffthreadVideo>사용<video>사용 금지 - 지속 시간을 초 단위로 작성하고
fps를 곱하여 사용 defaultProps타입 안전성을 위해satisfies키워드 사용