vtuber-promo

name	vtuber-promo
description	AUTORIG 캐릭터의 "버튜버가 만들어지는 과정"을 홍보 쇼츠로 만든다 — 백지→파츠함 생성→무대 조립→초록 리깅 순차 등장→웹캠으로 직접 구동까지. 캐릭터 무관(character.json 일반 파싱). 트리거 — "홍보 영상/쇼츠 만들기", "제작 과정 녹화", "버튜버 만들어지는 영상", "유튜브 홍보 영상", "조립 영상", "리깅 과정 보여주는 영상". 빌드는 vtuber-autorig, 배포·방송은 vtuber-deploy. 2026-06-18 007 나비로 실증.

VTuber 제작과정 홍보 쇼츠 (ASSEMBLY-SHOWREEL-001)

완성된 rig(rig_v0_project)를 "무에서 만들어지는 과정" 영상으로 보여주는 경로. 파이프라인 자동 단계가 아니라 on-demand 스킬(deploy의 형제) — 웹캠 피날레는 사람이 직접 해야 하기 때문.

서사 4단계(?assembly=1, 결정론 타임라인 ~16초 + 웹캠):

1. 백지 → 왼쪽 파츠함에 파츠가 스태거로 생성
2. 파츠가 오른쪽 무대로 날아가 부착(조립)
3. 초록 리깅(메시+디포머)이 순차적으로 "입혀짐" (한 번에 안 뜸)
4. 중앙 풀바디 클로즈업 → 웹캠으로 직접 구동(초록 리깅 OFF, 우측 파라미터 패널이 얼굴 따라 실시간 반응)

핵심 사실(2026-06-18 007 실증):

• 캐릭터 무관 — character.json의 parts·meshes·deformers를 일반 파싱. 005/006/007/미래 누구나.
• pixi(GPU) 필수 — canvas(CPU 2D)는 웹캠 트래킹과 겹쳐 뚝뚝 끊김. assembly 드라이브는 pixi 유지.
• 캡처 해상도 중요 — 헤드리스 프레임 캡처는 viewport scale 2(2160²) 로. scale 1(1080²)은 2048 캔버스 다운스케일로 얼굴 뭉개짐.

⚠️ parts PNG는 gitignore라 풀런 재실행이 덮음([[autorig-rerun-overwrites-textures]]) — 작업 전 rig_v0_project/ 백업.

0. 텍스처 백업

cp -r experiments/<id>/rig_v0_project experiments/<id>/rig_v0_project.bak_promo_$(date +%Y%m%d_%H%M%S)

1. 두 가지 녹화 경로

쇼츠 = (A) 결정론 빌드 쇼츠 + (B) 웹캠 피날레를 편집에서 이어붙임. A는 자동·재현 가능, B는 사람이 연기.

A. 결정론 빌드 쇼츠 (웹캠 없음 — 자동/헤드리스 가능)

빌드→조립→리깅 리빌까지. 결정론이라 같은 명령이면 매번 동일 영상.

# 프리뷰 서버 (앱만)
python3 scripts/mini_cubism_preview_server.py --project experiments/<id>/rig_v0_project --port 8050
# 화면 녹화용 URL (자동 재생, 다시보기=새로고침):
#   http://127.0.0.1:8050/?clean=1&assembly=1            (베이지)
#   http://127.0.0.1:8050/?obs=1&assembly=1              (초록 크로마키 합성용)
#   http://127.0.0.1:8050/?clean=1&assembly=1&automotion=1  (웹캠 없이 스크립트 모션 미리보기)

헤드리스 결정론 MP4 레시피(agent-browser + ffmpeg, 1080² 24fps ~24초):

# 1) viewport scale 2(2160²)로 캡처 세션 — scale 1은 얼굴 뭉개짐
agent-browser --session cap set viewport 1080 1080 2
agent-browser --session cap open "http://127.0.0.1:8050/?clean=1&assembly=1"
agent-browser --session cap eval '(async()=>{await window.__miniProbe.waitReady(8000); window.__assembly.stop(); return 1})()'
# 2) seek+screenshot 배치 (576프레임). python으로 JSON 생성 후:
#    [["eval","window.__assembly.seek(<t>)"],["screenshot","/tmp/frames/fNNNN.png"], ...]  (t=i/24)
agent-browser --session cap batch --json < /tmp/cap.json
# 3) 합성 (2160²→1080² lanczos = 선명)
ffmpeg -y -framerate 24 -i /tmp/frames/f%04d.png -c:v libx264 -pix_fmt yuv420p -crf 18 \
  -preset slow -vf scale=1080:1080:flags=lanczos -movflags +faststart out.mp4

또는 그냥 Cmd+Shift+5(macOS)로 위 URL 창을 화면 녹화 — 더 빠르고 화면 픽셀 그대로라 선명.

B. 웹캠 피날레 (사람이 직접 — "이게 진짜 리깅 작업"임을 보여줌)

python3 scripts/run_mini_cubism_webcam_drive.py \
  --project experiments/<id>/rig_v0_project --port 8060 --assembly
# 브라우저: http://127.0.0.1:8060/drive?panel=1   (웹캠 미리보기+모델)
#           http://127.0.0.1:8060/drive?obs=1      (초록 크로마키 풀스크린)

흐름: 카메라 허용 → 빌드 자동 재생(~16초, 백지→조립→리깅 입혀짐→중앙 클로즈업) → 얼굴 움직이면 캐릭터가 따라 움직임. Cmd+Shift+5로 녹화. 처음부터 다시 = 새로고침.

웹캠 시작 시 자동 처리(__assembly.showRig(false)): 초록 리깅 OFF(성능) + 모든 파츠 완전 조립 + FOCUS 정중앙 스냅 + 줌/팬 리셋(휠 조정 불필요) + 우측 파라미터 패널 복귀. → 언제 켜든 패널 정중앙·동일 크기.

2. 편집

테이크 A(빌드)+B(웹캠) 스티칭 + 음악. 자막 없이 비주얼로(주인님 선호). 세로 쇼츠는 9:16 크롭 — 단 빌드 단계는 2분할(파츠함 좌)이라 가로가 넓으니 크롭 시 유의(클로즈업 구간만 9:16로 따로 뽑거나 1:1 유지).

튜닝 노브 (모두 mini_cubism_app/src/assembly.js)

대상	위치	기본
단계 타이밍	const T (blank/spawnSpan/flyStart/flySpan/camStart~End/rigIn/rigRevealDur/end)	end 16.6
빌드 무대(우측)	STAGE_BUILD {cx,cy,s}	1440,1044,0.62
최종 크기·중앙	STAGE_FOCUS {cx,cy,s}	1024,1003,0.82
파츠함 레이아웃	BIN {x0,y0,w,h,cols}	좌측 4열
리깅 등장 속도	T.rigRevealDur	2.8초

크기를 키우려면 STAGE_FOCUS.s만 올리면 됨. 드라이브 패널 폭은 scripts/templates/mini_cubism_drive.html .layout grid 첫 컬럼(300px).

트러블슈팅 (실제 겪은 것)

증상	원인	해결
웹캠 켜자마자 뚝뚝 끊김	렌더러가 canvas(CPU 2D)	pixi(GPU) — --assembly는 pixi 유지. canvas 강제 금지
MP4에서 얼굴 뭉개짐(라이브는 멀쩡)	캡처 viewport scale 1(1080²) → 2048 다운스케일	scale 2(2160²) 캡처 후 1080 lanczos
초록 리깅이 한 번에 뿅(기괴)	구버전	overlayReveal 순차 등장(rigRevealDur)
다시 시작하면 캐릭터 우측 치우침/휠 조정 필요	구코드 캐시 / 빌드 중 웹캠 시작	하드리프레시(⌘+Shift+R). showRig가 FOCUS 정중앙+줌/팬 리셋
pixi인데 초록 리깅 안 보임	clean/obs가 #overlay-canvas 숨김	body.rig-overlay로 빌드 단계만 표시(자동)
빌드 중 우측 패널이 캐릭터 가림	iframe이 clean 아님(에디터 UI)	패널 모드 iframe에 clean 자동 부여(템플릿)
디포머 박스가 왼쪽으로 새어나감	bounds [x,y,w,h]를 [l,t,r,b]로 오독	draw.js 수정됨(에디터 공통). 전체캔버스 워프는 쇼츠서 생략
파츠가 공중에 멈춤	빌드 완료 전 웹캠 시작	showRig가 t=999로 완전 조립 강제

한계 / 다음

• 웹캠 피날레는 자동화 불가(사람·카메라 필요) → 파이프라인 자동 단계 부적합. 결정론 빌드 쇼츠(A)만 헤드리스 자동화 가능.
• 증거: experiments/<id>/reports/assembly_showreel/. 엔진 커밋 a6807bd(+032411a).
• 9:16 세로 전용 레이아웃(파츠함 세로 재배치)은 미구현 — 필요 시 후속.