Remotion — 툴킷 확장 기능
핵심 Remotion 지식은
.claude/skills/remotion-official/에 있습니다(공식 remotion-dev/skills 저장소에서 동기화됨). 이 파일은 툴킷 전용 패턴만 다룹니다.
공유 컴포넌트
lib/components/에 있는 재사용 가능한 비디오 컴포넌트입니다. 템플릿에서 다음과 같이 임포트하세요:
import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
| 컴포넌트 | 용도 |
|---|---|
AnimatedBackground | 떠다니는 도형 배경 (변형: subtle, tech, warm, dark) |
SlideTransition | 장면 전환 (fade, zoom, slide-up, blur-fade) |
Label | 선택적 JIRA 참조가 있는 떠다니는 레이블 배지 |
Vignette | 영화 같은 가장자리 어둡게 처리 오버레이 |
LogoWatermark | 모서리 로고 브랜딩 |
SplitScreen | 나란히 비디오 비교 |
NarratorPiP | 화면 속 화면 발표자 오버레이 |
Envelope | 열리는 플랩 애니메이션이 있는 3D 봉투 |
PointingHand | 슬라이드인 및 펄스 효과가 있는 애니메이션 손 이모지 |
MazeDecoration | 모서리를 위한 애니메이션 등각 투영 그리드 장식 |
사용자 정의 전환
툴킷은 공식 @remotion/transitions 패키지를 넘어서는 장면 전환 효과를 위한 lib/transitions/ 라이브러리를 포함합니다.
TransitionSeries 사용
import { TransitionSeries, linearTiming } from '@remotion/transitions';
// lib에서 사용자 정의 전환 임포트 (프로젝트 위치에 따라 경로 조정)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// 공식 전환을 위해 @remotion/transitions에서 임포트
import { slide, fade } from '@remotion/transitions/slide';
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<TitleSlide />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={glitch({ intensity: 0.8 })}
timing={linearTiming({ durationInFrames: 30 })}
/>
<TransitionSeries.Sequence durationInFrames={120}>
<ContentSlide />
</TransitionSeries.Sequence>
</TransitionSeries>
사용 가능한 사용자 정의 전환
| 전환 | 옵션 | 최적 용도 |
|---|---|---|
glitch() | intensity, slices, rgbShift | 기술 데모, 날카로운 공개, 사이버펑크 |
rgbSplit() | direction, displacement | 현대 기술, 에너제틱 전환 |
zoomBlur() | direction, blurAmount | CTA, 고에너지 순간, 임팩트 |
lightLeak() | temperature, direction | 축하, 영화 미학, 따뜻한 순간 |
clockWipe() | startAngle, direction, segments | 시간 관련 콘텐츠, 장난기 있는 공개 |
pixelate() | maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness | 레트로/게이밍, 디지털 변환 |
checkerboard() | gridSize, pattern, stagger, squareAnimation | 장난기 있는 공개, 구조화된 전환 |
체커보드 패턴: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in
전환 예제
// 기술/사이버펑크 느낌
glitch({ intensity: 0.8, slices: 8, rgbShift: true })
// 따뜻한 축하
lightLeak({ temperature: 'warm', direction: 'right' })
// 고에너지 줌
zoomBlur({ direction: 'in', blurAmount: 20 })
// 색수차
rgbSplit({ direction: 'diagonal', displacement: 30 })
// 시계 방향 공개
clockWipe({ direction: 'clockwise', startAngle: 0 })
// 레트로 픽셀화
pixelate({ maxBlockSize: 50, glitchArtifacts: true })
// 체커보드 패턴
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })
전환 시간 가이드라인
| 유형 | 프레임 | 참고 |
|---|---|---|
| 빠른 컷 | 15-20 | 빠르고 강렬 |
| 표준 | 30-45 | 가장 일반적 |
| 극적 | 50-60 | 느린 공개 |
| 글리치 효과 | 20-30 | 갑작스러워야 함 |
| 라이트 릭 | 45-60 | 스윕할 시간 필요 |
전환 미리보기
모든 전환을 보려면 쇼케이스 갤러리를 실행하세요:
cd showcase/transitions && npm run studio
툴킷 모범 사례
- 프레임 기반 애니메이션만 사용 — CSS 전환/애니메이션은 렌더링 중 깜빡임을 유발하므로 피하세요
- useVideoConfig()에서 fps 사용 — 애니메이션을 프레임 속도와 무관하게 만듭니다
- 보간값 클램프 —
extrapolateRight: 'clamp'를 사용하여 값이 튀는 것을 방지하세요 - OffthreadVideo 사용 — 복잡한 컴포지션의 경우
<Video>보다 성능이 좋습니다 - 비동기 작업은 delayRender 사용 — 데이터가 준비될 때까지 항상 렌더링을 차단하세요
- 에셋은 staticFile 사용 —
public/폴더에서 파일을 올바르게 참조하세요 - 모든 프로젝트는 30fps 사용 — 타이밍: 프레임 = 초 × 30
- playbackRate는 일정해야 함 — 가변/극단 속도의 경우 FFmpeg로 사전 처리하세요
프로젝트 타이밍 규칙
| 장면 유형 | 시간 | 참고 |
|---|---|---|
| 제목 | 3-5초 (90-150f) | 로고 + 헤드라인 |
| 개요 | 10-20초 | 3-5개 불릿 포인트 |
| 데모 | 10-30초 | 맞게 playbackRate 조정 |
| 통계 | 8-12초 | 3-4개 통계 카드 |
| 크레딧 | 5-10초 | 빠른 페이드 |
속도: 음성 해설 기준 분당 약 150단어. 음성 해설이 타이밍을 결정합니다.
고급 API
모든 훅, 컴포넌트, 렌더러, Lambda 및 Player API에 대한 자세한 API 문서는 reference.md를 참조하세요.
라이선스 참고
Remotion에는 특별한 라이선스가 있습니다. 기업은 상업적 사용을 위해 라이선스를 취득해야 할 수 있습니다. https://remotion.dev/license 확인
피드백 및 기여
이 스킬에 누락된 정보나 개선할 부분이 있다면:
- 패턴이 누락되었나요? 필요한 것을 설명해 주세요
- 오류를 찾았나요? 무엇이 잘못되었는지 알려주세요
- 기여하고 싶나요? 다음을 도와드릴 수 있습니다:
- 이 스킬을 개선 사항으로 업데이트
- github.com/digitalsamba/claude-code-video-toolkit에 PR 생성
"이 스킬 개선"이라고 말하면 .claude/skills/remotion/SKILL.md 업데이트를 안내해 드립니다.