이 문서는 Remotion React 마크업 작성에 대한 지침입니다. 이 내용이 관련이 없다면 대신 Remotion 모범 사례를 불러오세요.
사용자 변경 사항 유지
사용자는 대화 외부에서 코드를 편집할 수 있습니다.
그동안 놀라운 변경이 감지되면 덮어쓰지 말고, 의도적인 것으로 간주하거나 확인을 요청하세요.
일반 규칙
useCurrentFrame() 및 interpolate()를 사용하여 애니메이션을 구동하세요.
CSS transition 또는 animation은 올바르게 렌더링되지 않으므로 리팩터링해야 합니다.
Tailwind 애니메이션 클래스는 올바르게 렌더링되지 않으므로 리팩터링해야 합니다.
Easing.bezier() 및 Easing.spring()을 사용하여 타이밍을 사용자 정의하세요.
Remotion 상호작용 모범 사례에 따라 마크업을 구성하세요.
편집 가능한 props가 있는 사용자 정의 시각적 컴포넌트에는 Interactive.withSchema({wrapInSequence: true})를 사용하고, 재사용 가능한 씬을 연결된 컴포지션으로 등록하세요.
타이밍을 지원하는 컴포넌트에 직접 타이밍을 배치하고, 중복되는 <Sequence> 래퍼를 피하세요.
premountFor를 지원하는 모든 타이밍 컴포넌트에 1초의 프리마운팅을 제공하세요:
premountFor={fps} (여기서 fps는 useVideoConfig()에서 가져옵니다). 미디어, 상호작용 컴포넌트, <Sequence>, <Series.Sequence>,
<TransitionSeries.Sequence>, <TransitionSeries.Overlay>에 적용하고, 씬 내부에 중첩된 타이밍 컴포넌트에도 포함하세요.
중첩된 항목이 부모 시작 전에 마운트되어야 하는 경우 부모 타임라인 항목도 프리마운트하세요.
premountFor가 없는 컴포넌트(예: <TransitionSeries.Transition>)는 대체가 필요하지 않습니다.
스튜디오는 항목을 생성한 JSX 소스 노드를 편집합니다. 모든 컴포지션 등록, 클립, 씬, 레이어 및 시퀀스는 자체 JSX 노드로, 편집 가능한 props를 인라인으로 포함하여 독립적으로 편집 가능해야 합니다. 프로그래매틱 루프는 생성된 인스턴스가 하나의 소스 템플릿으로 의도적으로 제어되는 경우에 적합하며, 사용자가 인스턴스를 개별적으로 편집해야 하는 경우에는 적합하지 않습니다.
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 prop에 인라인으로 유지하세요.
transform 대신 scale, translate, rotate CSS 속성을 사용하세요.
// 👍 인라인 편집 가능한 키프레임 및 transform 축약형
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 문자열은 스튜디오에서 편집하기 어려움
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
에셋
프로젝트 루트의 public/ 폴더에 에셋을 배치하세요.
staticFile()을 사용하여 public/ 폴더의 파일을 참조하세요.
미디어 컴포넌트
@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를 읽으세요.
예시 씬
배경 비디오와 하단 1/3 텍스트 오버레이가 있는 씬입니다.
하단 1/3은 자체 타임라인이 있는 상호작용 컴포넌트이며, 연결된 컴포지션으로 등록됩니다.
해당 텍스트는 children으로 전달되고 accentColor는 편집 가능한 prop입니다.
페이드 인은 호출 지점에서 인라인으로 키프레임이 지정됩니다.
// 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),
}),
}}
>
김철수, 제품 디자이너
</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: "텍스트" },
accentColor: {
type: "color",
default: "#0b84f3",
description: "강조 색상",
},
} 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: "김철수, 제품 디자이너",
accentColor: "#0b84f3",
}}
/>
</>
);
};
지연, 트리밍
지원하는 컴포넌트에 직접 타이밍을 배치하세요. 지원되는 props, 예시 및 작업 순서는 타이밍 props를 참조하세요.
지도
비디오에 지도를 포함하려면 Remotion 지도를 참조하세요.
텍스트 하이라이트 및 주석
텍스트 하이라이트(강조 표시), 원, 밑줄, 취소선, 텍스트 상자 등은 text-highlights.md를 참조하세요.
다중 씬 비디오
여러 개의 연속적인 씬이 있는 비디오를 계획 중이라면 multi-scene-video.md를 참조하세요.
연결된 컴포지션
씬 또는 레이어 그룹이 자체 편집 가능한 타임라인을 가져야 하는 경우 connected-compositions.md를 따르세요. 다중 씬 비디오에서 중요한 씬에는 이 구조를 선호하세요.
사전 컴포즈 액션
Ambient glow (src/BarChart.tsx:134) 사전 컴포즈와 같은 스튜디오 요청의 경우, 주어진 위치에서 선택된 시퀀스 마크업을 찾으세요. connected-compositions.md에 따라 연결된 컴포지션을 만드세요: 마크업을 명명된 컴포넌트로 추출하고, 가급적 Interactive.withSchema({wrapInSequence: true})로 상호작용 가능하게 만든 후, 동일한 내보낸 컴포넌트 참조를 고유한 <Composition>으로 루트에 등록하세요. 상호작용 컴포넌트를 타이밍 props와 함께 직접 렌더링하거나, 해당 래퍼에 목적이 있는 경우 시퀀스의 유일한 자식으로 렌더링하세요. 선택된 노드가 이미 시퀀스인 경우, 해당 props를 유지하고 자식을 추출하세요. 등록에는 부모 사용과 동등한 dimensions, fps, duration 및 defaultProps가 필요합니다. 등록된 컴포지션 없는 컴포넌트 추출은 사전 컴포즈 요청을 완료하지 않습니다.
음성 해설
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 또는 기타 웹 기술
- 요소에 직접 적용된 효과(
<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 지도를 불러오세요.
자막
자막 또는 캡션을 처리할 때는 Remotion 자막 스킬을 불러와 자세한 정보를 확인하세요.
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 파일을 불러오세요.
동적 지속 시간, 크기 및 데이터
컴포지션 지속 시간, 크기 및 props를 동적으로 설정하는 방법은 calculate-metadata.md를 참조하세요.
컴포지션 및 스틸
<Composition> 또는 <Still> 요소를 등록하기 전에 compositions.md에서 소스 편집 가능한 등록, 폴더, 기본 props 및 중첩에 대해 읽으세요. 씬의 자체 타임라인으로 스튜디오 탐색하려면 연결된 컴포지션을 사용하세요.
고급 시퀀싱
추가 시퀀싱 패턴(지연, 트리밍, 항목 지속 시간 제한)은 sequencing.md를 참조하세요.
모듈 설치
올바른 버전으로 새 패키지를 추가하려면 npx remotion add를 사용하세요:
npx remotion add @rem
…
[번역을 위해 잘림]