개요
이 스킬은 HyperFrames 컴포지션을 사용하여 오디오 파일로부터 파형 또는 비트 동기화 요소를 시각화하는 비디오를 생성합니다. 수동 편집 없이 트랙에 어울리는 시각 자료가 필요할 때 사용하세요. 컴포지션에서 최종 MP4를 렌더링합니다.
HyperFrames — 음악을 비디오로
음악 트랙 → 비트에 동기화된 비디오. 가사, 슬라이드쇼, 또는 키네틱 프로모. 음악이 진행 속도를 결정합니다.
사용 시기
- 사용자가 오디오 파일을 제공하고 비디오를 원할 때
- 사용자가 오디오를 추출할 비디오를 제공할 때 (음악 추출)
- 사용자가 분위기 브리핑을 제공할 때 ("제품 출시를 위한 경쾌한 로파이")
- 사용자가 가사 비디오를 원할 때 (단어가 보컬에 동기화됨)
- 사용자가 비트 동기화 슬라이드쇼를 원할 때 (비트에 맞춰 이미지 전환)
- 사용자가 키네틱 프로모를 원할 때 (트랙에 맞춰 맥박치는 타이포그래피)
사용하지 말아야 할 경우
- 사용자가 URL에서 제품 출시를 원할 때 (
hyperframes-product-launch-video사용) - 사용자가 토크 헤드 비디오를 원할 때 (
hyperframes-talking-head-recut사용) - 사용자가 내레이션/음성 해설을 원할 때 (
hyperframes-faceless-explainer사용) - 음악이 관련되지 않은 경우 (
hyperframes-motion-graphics사용)
워크플로우
1 · 오디오 해결
세 가지 입력 경로:
- 오디오 파일 제공:
ffprobe로 지속 시간, BPM 확인 (추정 또는 감지) - 비디오 제공:
ffmpeg -i input.mp4 -vn -acodec libmp3lame audio.mp3로 추출 - 분위기 브리핑: TTS/음악 모델로 생성하거나 카탈로그 BGM에서 선택
2 · 비트 구조 매핑
섹션 듣기 (또는 분석):
- 인트로 (0-8초) → 제목/설정
- 절 → 내용/슬라이드쇼
- 후렴/드롭 → 클라이맥스/키네틱 피크
- 아웃트로 → CTA/페이드 아웃
비트 맵 작성: [{ time: 0, section: "intro" }, { time: 8, section: "verse" }, ...]
3 · 장면을 섹션에 계획
각 음악 섹션은 시각적 처리를 받습니다:
- 인트로: 느린 페이드 인, 최소한의 움직임
- 절: 안정적인 등장, 2-4비트마다 한 요소
- 후렴: 최대 에너지 — 크기 폭발, 색상 변화, 빠른 컷
- 브릿지: 시각적 숨고르기 — 정적 유지 또는 느린 패닝
- 아웃트로: 종료 카드로 해결
4 · 컴포지션 빌드
모든 애니메이션 시작 시간을 비트 맵에 고정합니다. CSS 키프레임 또는 GSAP를 사용하며, 절대 시간이 섹션 경계와 일치해야 합니다.
<div id="main" data-composition-id="music-video"
data-start="0" data-duration="60" data-width="1080" data-height="1920" data-fps="30">
<div class="clip chorus-hit" data-start="32" data-duration="8" data-track-index="1">
<h1 class="lyric-line">후렴 가사</h1>
</div>
<audio data-start="0" data-duration="60" src="./track.mp3"></audio>
</div>
5 · 렌더링
npx hyperframes render --output music-video.mp4
동기화 확인: 섹션 경계에서 샘플 프레임을 추출하고, 시각적 변화가 비트에 맞춰 일어나는지 확인합니다 (±2프레임 허용 오차).
합리화 방지 표
| 합리화 | 현실 |
|---|---|
| "시간을 대충 맞출게" | 먼저 비트 맵 작성 — 모든 장면이 섹션 시간에 고정됨 |
| "전체적으로 동일한 에너지를 사용할게" | 후렴이 절보다 강하게 — 다이나믹이 중요함 |
| "오디오 검사를 건너뛸게" | 지속 시간/BPM 불일치가 전체 렌더링을 망침 |
| "벽시계 시간에 맞춰 애니메이션 할게" | 모든 애니메이션은 탐색 가능 — 컴포지션에 절대 시간 사용 |
확인 사항
- 오디오 해결됨 (파일, 추출, 또는 생성)
- 섹션 경계가 포함된 비트 맵 작성됨
- 각 섹션에 고유한 시각적 처리 있음
- 애니메이션 시간이 비트 맵과 일치함 (±2프레임)
- 출력 지속 시간이 오디오 지속 시간과 일치함
- 후렴/클라이맥스가 절과 시각적으로 구분됨