Revideo 성능 & 최적화

Revideo 프로젝트를 프로덕션 레벨로 만들 때 부딪히는 성능·자원 이슈와 해결책을 모았다. 자주 바뀌는 노드 격리로 dev 서버 hot-reload를 빠르게 유지하고, ffmpeg 디코더로 대용량 비디오를 효율적으로 처리한다.

---

📚 Revideo 성능 & 최적화 가이드

#	페이지	영문	핵심 내용
1	Revideo 자주 변경되는 노드 분리	Isolating Frequently Changed Nodes	Vite HMR 최적화, 컴포넌트 트리 shake
2	Revideo Decoders	Decoders	ffmpeg 기반 비디오 프레임 추출기, seek() 대체

---

🎯 상황별 가이드

목표	먼저 볼 페이지
dev 서버에서 코드 수정할 때마다 전체 리로드가 느릴 때	Revideo 자주 변경되는 노드 분리
<Video> seek()가 느리거나 끊길 때	Revideo Decoders
렌더링이 전반적으로 느릴 때	Revideo Slow Rendering (공식) — Slow Rendering
ffmpeg 관련 에러	Revideo FFmpeg Issues (공식) — FFmpeg Issues

---

⚡ 빠른 예시 (자주 바뀌는 노드 격리)

// Before — 전체 Scene이 매번 리로드됨
export default makeScene2D(function* (view) {
  yield view.add(<HeavyBackground />);
  yield view.add(<AnimatedText text={dynamicText} />);  // ← 이것만 바꿔도 전체 리로드
});

// After — 변경 빈도 낮은 부분을 분리
import {HeavyBackground} from './heavy-background';  // ← 별도 파일로 분리

export default makeScene2D(function* (view) {
  yield view.add(<HeavyBackground />);  // 리로드 영향 없음
  yield view.add(<AnimatedText text={dynamicText} />);  // 이 파일만 리로드
});

Vite는 import된 모듈 단위로 HMR(Hot Module Replacement)을 적용한다. 잘 안 바뀌는 큰 컴포넌트는 별도 파일로 빼두면 dev 서버 응답성이 크게 개선된다.

---

📚 영역 구분

• 렌더링이 느릴 때: Revideo 렌더링 → 이전 hub
• 도움말·커뮤니티: Revideo 플랫폼 & 도움말 → 다음 hub
• 공식 Common Issues: https://midrender.com/revideo/docs/common-issues

상위 문서: ← Revideo 사용 가이드 출처: Revideo 공식 문서 — Performance / Isolating Nodes / Decoders + Common Issues 한글화 (2026-07-29) 공급사: Revideo (현 Midrender)

변경 이력

날짜	변경
2026-07-29	초안 작성 — Revideo 성능 & 최적화 2개 영역 + Common Issues 링크
2026-07-29	메타데이터 블록을 본문 하단으로 이동