이 문서는 Remotion React 마크업 작성을 위한 안내입니다. 관련이 없을 경우 Remotion 모범 사례를 대신 로드하세요.
일반 규칙
useCurrentFrame()과 interpolate()를 사용하여 속성을 애니메이션 처리합니다.
spring()보다 interpolate()를 사용하세요.
Easing.bezier()를 사용하여 타이밍을 사용자 정의하세요. 깜빡이거나 오버슈팅하는 모션을 포함합니다.
스프링 애니메이션을 원한다면 Easing.spring()을 사용하세요.
Studio에서 상호작용이 가능해야 하는 HTML 요소는 Interactive를 사용하세요: <div> -> <Interactive.Div>.
Interactive, Solid, Sequence에 대해 설명적인 name prop(예: name="Hero title")을 설정하세요.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Title"
style={{
opacity: interpolate(frame, [0, 60], [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]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 값이 숨겨지고 transform 문자열이 Studio에서 편집하기 어려워짐
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
CSS 전환 또는 애니메이션은 금지입니다. 올바르게 렌더링되지 않습니다. Tailwind 애니메이션 클래스 이름은 금지입니다. 올바르게 렌더링되지 않습니다.
에셋은 프로젝트 루트의 public/ 폴더에 배치하세요.
public/ 폴더의 파일을 참조하려면 staticFile()을 사용하세요.
비디오와 오디오는 @remotion/media를 사용하여 추가하세요.
이미지는 <Img> 컴포넌트를 사용하여 추가하세요.
public/의 파일에는 staticFile()을 사용하거나 원격 URL을 직접 전달하세요.
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
콘텐츠를 지연시키려면 <Sequence>로 감싸고 from을 사용하세요.
요소의 지속 시간을 제한하려면 <Sequence>의 durationInFrames를 사용하세요.
<Sequence>는 기본적으로 장면을 덮는 절대 채움(absolute fill)입니다.
인라인 콘텐츠의 경우 layout="none"을 사용하세요.
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Background">
<Background />
</Sequence>
<Sequence name="Title" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtitle" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Title
</div>
);
};
export const Subtitle = () => {
return <div>Subtitle</div>;
};
텍스트 하이라이트 및 주석
텍스트 하이라이트(하이라이트 마커), 원, 밑줄, 취소선, 지워진 텍스트, 상자, 괄호에 대해서는 text-highlights.md를 참조하세요.
음성 해설
ElevenLabs TTS를 사용하여 Remotion 컴포지션에 AI 생성 음성 해설을 추가하는 방법은 voiceover.md를 참조하세요.
트리밍
트리밍 패턴(애니메이션의 시작 또는 끝 자르기)에 대해서는 trimming.md를 참조하세요.
비디오 임베딩
비디오 임베딩(트리밍, 볼륨, 속도, 루핑, 피치)에 대한 고급 지식은 embedding-videos.md를 참조하세요.
비디오 편집
Remotion Studio에서 편집 가능한 비디오 타임라인 구조화에 대해서는 video-editing.md를 참조하세요.
오디오 임베딩
트리밍, 볼륨, 속도, 피치와 같은 고급 오디오 기능은 audio.md를 참조하세요.
전환(Transition)
장면 전환 패턴에 대해서는 transitions.md를 참조하세요.
시각 및 픽셀 효과
시각 효과를 만들 때는 다음 순서를 선호합니다: 1. 일반 Remotion/HTML/CSS/SVG/filter/blend/mask 애니메이션, 2. effects.md를 통해 나열된 효과(HTML rendered through <HtmlInCanvas> 포함), 3. 사용자가 재사용 가능하거나 프로젝트별 효과를 요청할 때 effects.md를 통한 커스텀 createEffect(), 4. 효과가 맞지 않을 경우에만 html-in-canvas.md를 통한 커스텀 <HtmlInCanvas onPaint>.
라이트 릭 오버레이에 대해서는 light-leaks.md를 참조하세요. 문서: https://www.remotion.dev/docs/effects
사용 가능한 효과: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), roughenEdges(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
3D 콘텐츠
Three.js 및 React Three Fiber를 사용한 Remotion의 3D 콘텐츠는 3d.md를 참조하세요.
사운드 효과
사운드 효과를 사용해야 할 때는 ./sfx.md 파일을 로드하여 자세한 정보를 확인하세요.
오디오 시각화
오디오를 시각화(스펙트럼 막대, 파형, 베이스 반응 효과)해야 할 때는 ./audio-visualization.md 파일을 로드하여 자세한 정보를 확인하세요.
자막
자막 또는 캡션을 다룰 때는 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를 참조하세요.
고급 컴포지션
스틸, 폴더, 기본 props 정의 및 컴포지션 중첩 방법은 compositions.md를 참조하세요.
고급 시퀀싱
지연, 트리밍, 항목 지속 시간 제한 등 더 많은 시퀀싱 패턴은 sequencing.md를 참조하세요.
모듈 설치
npx remotion add를 사용하여 올바른 버전의 새 패키지를 추가하세요.
npx remotion add @remotion/media
이는 @remotion/* 패키지, mediabunny, @mediabunny/*, zod에 적용됩니다.
마크업 미리보기
사용자가 미리보기를 보고 싶어한다고 판단될 때만 수행하세요.
npx remotion studio --no-open
이렇게 하면 장기 실행 프로세스가 시작되고 미리보기 서버 URL이 출력됩니다. 이미 시작된 경우 URL이 출력됩니다.
선택 사항: 단일 프레임 렌더링 확인
레이아웃, 색상 또는 타이밍을 확인하기 위해 CLI로 단일 프레임을 렌더링할 수 있습니다. 사소한 편집, 순수 리팩터링, 또는 Studio나 이전 렌더링을 통해 충분한 확신이 있는 경우에는 건너뛰세요.
npx remotion still [composition-id] --scale=0.25 --frame=30
30fps에서 --frame=30은 1초 지점입니다(--frame은 0부터 시작).