Remotion 비디오 툴킷은(는) 무엇을 하나요?
개요
React와 Remotion을 사용하여 프로그래매틱 방식으로 비디오를 생성합니다. 재사용 가능한 비디오 템플릿을 React 컴포넌트로 구축하고, CLI 또는 클라우드 인프라를 통해 MP4/WebM으로 렌더링하며, 대규모 개인화 비디오를 생성할 수 있습니다. 자동화된 소셜 미디어 콘텐츠, 애니메이션 데이터 시각화, 동적 비디오 제작 파이프라인에 이상적입니다.
지침
사용자가 프로그래매틱 비디오 생성을 요청하면, 다음 작업을 결정합니다:
작업 A: Remotion 프로젝트 설정
# 새 Remotion 프로젝트 생성
npx create-video@latest my-video
cd my-video
npm start # Remotion Studio가 http://localhost:3000 에서 열립니다
프로젝트 구조:
my-video/
src/
Root.tsx # 모든 컴포지션 등록
MyComposition.tsx # 비디오 컴포넌트
remotion.config.ts # 렌더링 설정
작업 B: 비디오 컴포지션 생성
모든 Remotion 비디오는 useCurrentFrame()과 useVideoConfig()를 사용하는 React 컴포넌트입니다:
import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, spring } from "remotion";
interface MyVideoProps {
title: string;
subtitle: string;
bgColor: string;
}
export const MyVideo: React.FC<MyVideoProps> = ({ title, subtitle, bgColor }) => {
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
// 제목이 슬라이드되어 들어오는 애니메이션
const titleY = spring({ frame, fps, from: -100, to: 0, durationInFrames: 30 });
// 20프레임 후 부제목 페이드 인
const subtitleOpacity = interpolate(frame, [20, 40], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: bgColor, justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontSize: 80, color: "white", transform: `translateY(${titleY}px)` }}>
{title}
</h1>
<p style={{ fontSize: 36, color: "rgba(255,255,255,0.8)", opacity: subtitleOpacity }}>
{subtitle}
</p>
</AbsoluteFill>
);
};
Root.tsx에서 컴포지션을 등록합니다:
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}
defaultProps={{ title: "Hello World", subtitle: "Made with Remotion", bgColor: "#1a1a2e" }}
/>
);
};
작업 C: 틱톡 스타일 애니메이션 자막 추가
import { AbsoluteFill, useCurrentFrame, Sequence } from "remotion";
interface CaptionWord {
text: string;
startFrame: number;
durationInFrames: number;
}
const captions: CaptionWord[] = [
{ text: "This", startFrame: 0, durationInFrames: 15 },
{ text: "is", startFrame: 15, durationInFrames: 10 },
{ text: "amazing!", startFrame: 25, durationInFrames: 20 },
];
export const CaptionOverlay: React.FC = () => {
const frame = useCurrentFrame();
const activeWord = captions.find(
(c) => frame >= c.startFrame && frame < c.startFrame + c.durationInFrames
);
return (
<AbsoluteFill style={{ justifyContent: "flex-end", alignItems: "center", paddingBottom: 120 }}>
{activeWord && (
<div style={{
fontSize: 64,
fontWeight: "bold",
color: "white",
textShadow: "2px 2px 8px rgba(0,0,0,0.8)",
backgroundColor: "rgba(0,0,0,0.5)",
padding: "8px 24px",
borderRadius: 12,
}}>
{activeWord.text}
</div>
)}
</AbsoluteFill>
);
};
작업 D: 비디오 렌더링
# 로컬에서 CLI를 통해 렌더링
npx remotion render MyVideo out/video.mp4
# 사용자 정의 props로 렌더링
npx remotion render MyVideo out/video.mp4 --props='{"title":"Custom Title"}'
# 스틸 프레임 렌더링 (썸네일 용)
npx remotion still MyVideo out/thumbnail.png --frame=45
# 특정 코덱 및 품질로 렌더링
npx remotion render MyVideo out/video.mp4 --codec=h264 --crf=18
대규모 배치 렌더링:
# AWS Lambda에서 렌더링
npx remotion lambda render MyVideo --props='{"title":"Video 1"}'
# Google Cloud Run에서 렌더링
npx remotion cloudrun render MyVideo --props='{"title":"Video 1"}'
작업 E: 애니메이션 데이터 시각화
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
interface DataPoint { label: string; value: number; color: string; }
export const BarChart: React.FC<{ data: DataPoint[] }> = ({ data }) => {
const frame = useCurrentFrame();
const maxVal = Math.max(...data.map((d) => d.value));
return (
<AbsoluteFill style={{ padding: 80, justifyContent: "flex-end", backgroundColor: "#0f0f23" }}>
<div style={{ display: "flex", alignItems: "flex-end", gap: 20, height: "70%" }}>
{data.map((point, i) => {
const height = interpolate(frame, [i * 10, i * 10 + 30], [0, (point.value / maxVal) * 100], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
return (
<div key={i} style={{ flex: 1, textAlign: "center" }}>
<div style={{
height: `${height}%`,
backgroundColor: point.color,
borderRadius: "8px 8px 0 0",
transition: "height 0.3s",
}} />
<p style={{ color: "white", marginTop: 12, fontSize: 24 }}>{point.label}</p>
</div>
);
})}
</div>
</AbsoluteFill>
);
};
예제
예제 1: 개인화된 환영 비디오
사용자 요청: "각 신규 사용자에 대해 이름이 포함된 환영 비디오 생성"
# JSON 사용자 목록에서 비디오 생성
for user in $(jq -r '.[] | @base64' users.json); do
name=$(echo "$user" | base64 -d | jq -r '.name')
npx remotion render WelcomeVideo "out/welcome_${name}.mp4" \
--props="{\"userName\":\"${name}\"}"
done
예제 2: 애니메이션 영업 대시보드
사용자 요청: "분기별 지표가 애니메이션으로 나타나는 비디오 생성"
분기별 데이터로 BarChart 컴포넌트를 사용하여 컴포지션을 구축하고, 다음 명령어로 렌더링:
npx remotion render SalesDashboard out/q4_report.mp4 \
--props='{"quarter":"Q4","revenue":1250000,"growth":12.5}'
예제 3: 자막이 포함된 소셜 미디어 콘텐츠
사용자 요청: "틱톡용 비디오에 애니메이션 자막 추가"
CaptionOverlay를 OffthreadVideo 소스와 결합:
import { OffthreadVideo } from "remotion";
<AbsoluteFill>
<OffthreadVideo src="https://example.com/clip.mp4" />
<CaptionOverlay />
</AbsoluteFill>
지침
- 모든 애니메이션에
useCurrentFrame()과interpolate()를 사용하고, CSS 전환은 피하세요. - 컴포지션을 순수하게 유지하세요: 모든 동적 데이터를 props로 전달하여 배치 렌더링을 쉽게 만드세요.
<Sequence>를 사용하여 비디오 타임라인의 섹션을 구성하세요.- 비디오 소스의 성능을 위해
<Video>대신<OffthreadVideo>를 선호하세요. - 좋은 품질 대 크기 비율을 위해
crf(Constant Rate Factor)를 16-20 사이로 설정하세요. - Lambda 렌더링의 경우, 시간 초과 문제를 피하기 위해 컴포지션을 120초 미만으로 유지하세요.
- 렌더링 전에 Remotion Studio에서 테스트하여 레이아웃 문제를 조기에 발견하세요.
public/폴더의 에셋을 참조하려면staticFile()을 사용하세요.