HTML Motion Pipeline (9:16 설명, VO + SFX → MP4)은(는) 무엇을 하나요?
검증된 워크플로우입니다. 각 단계마다 assets/pipeline/에 바로 사용할 수 있는 명령어가 준비되어 있습니다.
전체 구현 참조: assets/pipeline/index.fc-reference.html (Function Calling 프로젝트 — 복사한 후 콘텐츠를 교체하고, 처음부터 작성하지 마세요).
이 파이프라인이 필요한 이유
- 결정론적: GSAP 타임라인이
paused상태로 프레임 단위로 탐색되며 → MP4는 미리보기와 동일합니다. - 사용자 직접 VO (ElevenLabs/마이크 파일), TTS 아님; 템포는 수동 제어합니다.
- 자동 레이아웃 감사가 텍스트 캔버스 이탈 및 요소 충돌을 감지하여 — 전체 렌더링 전에 반드시 통과해야 합니다(1338프레임 렌더링 절약).
- 깔끔한 연결선: 노드 가장자리에 앵커를 배치하고 뒷 레이어에 배치합니다 (Pitfall #1 참조).
핵심 원칙 (이것이 핵심입니다)
시각 요소는 대본 & VO를 따라야 하며, 그 반대가 되어서는 안 됩니다.
- 화면에 표시되는 모든 것은 대본에 있어야 하며 VO에서 말해져야 합니다. 아무리 예뻐도 내레이션이 없는 요소는 제거하세요.
- 반대로, 대본의 모든 중요한 아이디어/문장에는 해당 구절이 말해질 때 나타나는 고유한 그림이 있어야 합니다. 단순히 텍스트로만 존재하는 문장은 '조용한' 장면입니다 → 시각 자료를 추가하세요.
- 장면이 많아도 괜찮습니다 — 중요한 것은 각 장면이 VO와 대본을 따른다는 것입니다.
- 그림과 애니메이션이 많을수록 좋습니다 (더 생동감 있습니다). 시각 자료를 아끼지 마세요; 풍부한 시각 자료는 약점이 아닌 강점입니다.
- 시각 자료의 순서와 타이밍 = VO에서 언급되는 순서와 타이밍 (타임스탬프 기준)이며, 임의로 정하지 마세요.
- 시각적 디테일의 품질도 유지되어야 합니다: 아이콘이 무엇을 의미하는지 명확하게 읽혀야 하고, 요소가 균형을 이루며 허공에 떠 있지 않아야 합니다.
워크플로우 (순서대로 따르세요)
| # | 단계 | 출력 |
|---|---|---|
| 1 | 사용자 VO 수집 및 세그먼트 분할 (숨 쉬는 간격 기준) | meta.json |
| 2 | ffmpeg atempo로 VO 템포 조절 + 간격 삽입; 변형 선택 | vo.wav |
| 3 | 단어 단위 전사 (faster-whisper, pip install faster-whisper) | assets/words.json |
| 4 | index.html 빌드 (VO 타이밍에 맞춘 8개 장면) + sfx_score.py | HTML + SFX WAV |
| 5 | VO + SFX 믹스 → public/full_mix.mp3 | 최종 오디오 |
| 6 | 레이아웃 감사 (audit2.mjs + audit_s2.mjs) — 반드시 오버플로우 0 | 보고서 |
| 7 | 프레임 렌더링 (render_frames.mjs) → 1338 PNG | frames/ |
| 8 | 인코딩 (encode.sh) → MP4 | public/*.mp4 |
| 9 | 최종 MP4 시각 확인 — MP4에서 프레임 추출, vision 분석 | 깨끗함 확인 |
초기 설정 한 번
cd <프로젝트>
npm init -y && npm install playwright-core gsap
pip install faster-whisper # 단어 단위 전사용
# 필요: Google Chrome (/Applications/Google Chrome.app), ffmpeg
파이프라인 스크립트
assets/pipeline/:
render_frames.mjs— 타임라인을 프레임별로 탐색, 1080×1920 @30fps 스크린샷을 찍습니다.snap.mjs— 특정 초의 스냅샷 (node snap.mjs 1.0 6.5 17.5)을 찍어 시각적 확인을 합니다.audit2.mjs— 모든 장면을 검사합니다: 텍스트 캔버스 이탈 / 하단 UI 영역(>1560px) 침범 / 충돌.audit_s2.mjs— 여러 초에 걸쳐 단일 장면(sc2)을 감사합니다 (너무 이른 공개, 가장자리 근접 감지).audit_overlap.mjs— 실제로 겹치는 텍스트를 감지합니다 (텍스트×텍스트, 텍스트×이미지, 텍스트×버튼). 설계상 허용되는 충돌(예: SVG 컨테이너 내부 레이블, 취소선/관통선, 나란히 배치된 자막 플렉스)을 지능적으로 구분하여 보고하지 않습니다.node assets/pipeline/audit_overlap.mjs실행 →TOTAL 겹침: 0이 목표입니다.audit_center.mjs— '위로 떠 있는' 콘텐츠를 감지합니다 (하단 2/3가 비어 있음). 각 장면의 콘텐츠 바운딩을 측정하고 이상적인 중앙(y≈960, 1920px 기준)으로부터의 편차를 계산합니다. 편차 > 250px = ⚠ 떠 있음.node assets/pipeline/audit_center.mjs로 실행하세요.typing-prompt.js— '타이핑 프롬프트' 애니메이션 레시피 (코딩/AI 테마의 핵심): 프롬프트가 한 글자씩 타이핑되고 커서가 깜빡이며, 앱이 응답합니다(색상 변경 → 오류 → 수정 → 반복). 전체 예제: 리포지토리09-vibe-coding/index.htmlSK4 장면.encode.sh— ffmpeg → H.264 yuv420p CRF18 + AAC 192k ++faststart.sfx_score.py— 단어 타이밍에 동기화된 절차적 SFX 스코어.index.fc-reference.html— 전체 구현 (복사 후 콘텐츠 교체).
HTML 규칙 (index.fc-reference.html 기준)
#stage1080×1920, 점 그리드 배경;#world(카메라 리그, 장면별 미세 스케일); 장면 =.scene(visibility hidden, 타임라인으로 show/hide).- 단어 단위 자막:
assets/words.json→ 최대 4단어 덩어리로 그룹화, 각 덩어리 = 하나의.line(position:absolute, 상자를 확장하지 않도록 쌓음), 활성 단어.on, 키워드.key(호박색). 아래쪽에서 390px 위치 (릴스/틱톡 하단 ~360px을 가리는 UI 영역으로부터 안전함). - 연결선:
link(svg, idA, idB)함수가 노드 가장자리(edge/edgeT)에 앵커를 계산합니다 — 선이 로고 중앙에서 나오지 않습니다. SVG.wires는.scene의 첫 번째 자식으로 배치됩니다(z-index:0) (카드 뒤에, z-index:2). 부드러운 곡선(bow ≤26px), 회색#7A81888px; 활성 선.hot은 호박색 15px. - 에이전트 로고:
OPENCLAW_SVG인라인 (붉은 랍스터),🤖가 포함된 모든.node.dark에 자동으로 적용됩니다. 다른 아이덴티티로 변경하려면 교체하세요. - GSAP 결정론적: 타임라인
paused,window.__tl&window.__updateSub노출. 정적 스냅샷(헤드리스)은?t=<초>, 수동 스크러빙은?debug모드.
트리거
사용자가 **