HyperFrames 프로덕션
승인된 스토리보드를 구현합니다. 스토리보드가 없으면 중단하고 motion-storyboard를 실행하세요.
렌더러 선택
| 상황 | 렌더러 |
|---|---|
| 새 작업의 기본값; HTML/CSS/GSAP 기술 사용; 레지스트리 블록 필요 | HyperFrames (npx hyperframes …) |
| 프로젝트가 이미 Remotion 사용 | Remotion 유지; 동일한 결정론 규칙 적용 |
제품 저장소에 자체 스튜디오(seek(t) + Playwright + FFmpeg)가 이미 있음 | 해당 스튜디오 사용; 두 번째 스튜디오를 도입하지 마세요 |
| 기존 영상의 순수 편집 | 이 스킬 건너뛰기 → video-edit-qc |
HyperFrames CLI를 설치하거나 레지스트리 블록(npx hyperframes add …)을 추가하면 타사 코드가 설치됩니다. 사용자와 먼저 확인하고 package.json에 버전을 고정하세요. 스킬에 대한 자체 업데이트 명령(npx hyperframes skills update, npx skills add …)을 스스로 실행하지 마세요.
합성 규약 (HyperFrames)
- 독립형 루트:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">를<body>에 직접 배치하고, 크기는width/height: 100%로 설정합니다. 루트에 픽셀 크기를 하드코딩하지 마세요. 하위 합성(data-composition-src로 로드됨)은<template>안에 루트를 감싸고<style>/<script>를 그 안에 유지합니다. - 합성당 하나의 일시 중지된 타임라인:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true })를 빌드 완료 후 등록합니다 (document.fonts.ready안에서 빌드될 수 있음). 렌더링 길이는 루트data-duration에서 가져옵니다. - 시간 제한 클립:
class="clip"과data-start/data-duration속성을 가진 요소는 런타임에 의해 표시/숨겨집니다..clip에서display,visibility또는autoAlpha를 트윈하지 말고, 자식을 애니메이션 처리하세요. - 변환: CSS 초기
transform과 동일한 속성에 GSAP 트윈을 함께 사용하지 마세요.gsap.fromTo를 사용하세요. 이동하는 노드에는translate(-50%,-50%)대신 flex/inset으로 중앙 정렬하세요. - 미디어: 모든
<audio>에는id가 있어야 합니다 (그렇지 않으면 렌더링이 무음). 미디어에crossorigin을 설정하지 마세요.<video>와 상위 요소에 동시에data-start를 배치하지 마세요. - 폰트: 모든 명명된
font-family는 제공된 로컬 파일을 가리키는 파일 내@font-face를 가져야 합니다. - 결정론: 벽시계 읽기, 시드되지 않은
Math.random, 렌더링 시간 네트워크 페치, 입력 상태, 무한 반복(repeat: -1)을 금지합니다. 난수가 필요할 때는 시드된 PRNG를 사용하세요. - ID: 조합된 페이지 전체에서 고유해야 합니다. 하위 합성 ID 앞에 해당 합성 ID를 접두사로 붙이세요.
빌드 순서
npx hyperframes init(확인 후) 또는 기존 프로젝트 열기.- 디자인 사양(
frame.md/design.md) 작성: 토큰, 타입 스케일, 그리드, 안전 영역, 가로세로 비율별. 먼저 정지 프레임을 작성하세요. 각 비트는 스틸 이미지로 작동해야 합니다. - 스토리보드 순서대로 장면별로 구축하고 전환 맵(
motion-choreography)에서 이음새를 구현하세요. 캐리어 먼저. voice-video-sync에서 오디오 배치: 배경 음악, 음성 해설, SFX. 타임라인 파일의 ID와 시작 시간 사용. 수동 입력 추측 금지.- 텍스트를 선명하게 유지: 컨테이너를 이동하고, 글리프는 이동하지 마세요. 텍스트에
will-change를 사용하지 마세요.
검증
다음 순서대로 실행하고 다음 단계로 넘어가기 전에 수정하세요:
npx hyperframes lint # 규약 오류; 린트 오류는 레이아웃/대비 감사 비활성화
npx hyperframes check # 레이아웃, 넘침, 대비
npx hyperframes snapshot # 리뷰용 스틸 이미지; 스토리보드 비트와 비교
npx hyperframes preview # 사용자용 로컬 미리보기
그런 다음 로컬 렌더링: npx hyperframes render --quality <draft|high>. 사용자 승인을 위해 먼저 드래프트(≤30초 윈도우 또는 낮은 화질)를, 그다음 최종본을 렌더링하세요.
외부 지향 명령(publish, cloud, lambda, cloudrun, feedback, auth, 텔레메트리 설정)은 데이터를 업로드하거나 계정을 변경합니다. 사용자가 요청할 때만 실행하세요.
사용자 정의 seek(t) 파이프라인 (HyperFrames를 사용하지 않을 때)
composition(t) → Playwright page.evaluate(seek, t) → 폰트/이미지 대기 → 스크린샷
→ 출력 프레임당 N개의 하위 프레임 → ffmpeg tmix (모션 블러) → x264/x265 → 오디오 믹싱
- 60fps × 4개의 하위 프레임, 셔터 0.5가 좋은 기본값입니다. 숫자가 변경되는 프레임에서 블러가 가독성을 해치는 경우 블러를 제거하세요.
- 마스터 인코딩(아카이브 및 재편집 소스):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow, AAC 320 kbps. 플랫폼 전달 인코딩은video-edit-qc에서 파생됩니다. - 동일한 타임스탬프를 두 번 렌더링하면 동일한 픽셀이 생성되어야 합니다. 무작위 프레임 3개에서 테스트하세요.
인계
렌더링 결과와 스틸 이미지/접촉 시트를 video-edit-qc에 전달하세요. HyperFrames 스킬이 설치된 경우(hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli), 정확한 플래그, 어댑터(Lottie, Three.js 등) 및 레지스트리 블록 이름에 사용하세요.