단편 세로 비디오 (Hyperframes)
단편 비디오 = 1080x1920 세로, 10~30초, 얼굴 영상 + 모션 그래픽 장면 오버레이 + 가라오케 자막. 이 스킬의 모든 내용은 May Shorts 19 반복 분석(v1 → v4)에서 추출되었으며, 모든 새로운 단편 비디오에 적용되어야 합니다.
항상 먼저 /hyperframes를 호출하세요. 이 스킬은 그 위에 위치합니다 — 프레임워크 규칙(data-* 속성, window.__timelines, 구성 구조)을 대체하지 않습니다. 이러한 규칙은 형식과 관계없이 절대적으로 지켜야 합니다.
이 스킬이 실행되는 경우
- "단편 비디오 만들기", "TikTok 게시물", "Reels", "Shorts", "세로 비디오"
- 소셜 미디어용 얼굴 녹화 + 대본/트랜스크립트로 시작하는 모든 제작
- 기존 단편 비디오의 리타이밍, 재편집, 또는 재동기화
- 음성 해설에 동기화된 가라오케 자막 추가
플레이북 (상위 수준)
- 오디오가 진리입니다. 오디오를 먼저 편집하세요(재녹음, 일시 중지 제거).
<name>-edit.mp4로 저장하세요.ffprobe로 정확한 길이를 측정하세요 — 이것이 구성의data-duration입니다. - 편집된 오디오를 전사하세요:
npx hyperframes transcribe <edit>.mp4 --model small.en --json. 또는 기존 자막에shift()함수가 있는 경우 기존 자막을 유지하고 장면 시작만 이동하세요. - 편집된 시간으로 장면 경계를 작성하세요 — 절대 원본 시간과 편집 시간 앵커를 같은 파일에 혼용하지 마세요. "오디오 동기화 프로토콜"을 참조하세요.
- 구성 뼈대를 만드세요 (4개 레이어: 주변 배경, 이음새 처리, 자막, 얼굴) — 아래 "구성 뼈대"를 참조하세요.
- 각 장면의
data-start를 기준으로 상대적인 LOCAL 오프셋으로 장면을 작성하세요. 각 장면은compositions/scene<N>-<label>.html아래의 자체 하위 구성입니다. - 린트 → 드래프트 렌더링 → 단어 정확도 프레임 검증 → 최종 렌더링. 이것이 검증 게이트입니다. 3단계(프레임 검증)를 절대 건너뛰지 마세요.
구성 뼈대 (항상 켜져 있는 4개 레이어)
모든 단편 세로 비디오는 compositions/ 아래에 이 4개의 하위 구성을 가지며, 공유 트랙에 로드됩니다:
index.html (루트, 1080x1920, data-composition-id="main")
├── ambient-bg.html track-index="3" — 방사형 그라데이션 + 드리프트 그리드 + 입자 + 비네트
├── face-wrapper + <video> track-index="0" — 얼굴 영상 (얼굴 모드 안무 참조)
├── seam-treatment.html track-index="5" — y=960 가장자리 깃털 (하단 절반 장면만 해당)
├── scene1-<label>.html track-index="1" — 장면 오버레이 (연속, 간격 없음)
├── scene2-<label>.html track-index="1"
├── …
└── captions.html track-index="2" — 가라오케 자막, 단어 동기화
data-duration은 루트, ambient-bg, seam-treatment, face-video, face-audio, captions 전체에서 동일합니다. 장면 오버레이만 시간에 따라 변경됩니다.- 얼굴
<audio>는 별도의 요소(믹서가 필요함)이며, 비디오 자체 오디오 트랙을 사용하지 마세요. class="clip"은 시간 지정 div에만 사용하세요 —<video>나<audio>에는 절대 사용하지 마세요.
얼굴 모드 안무 (단편 비디오의 핵심 동작)
얼굴은 소스의 기본 가로(1920x1080) 크기로 설정된 래퍼 div 안에 있습니다. GSAP은 래퍼를 애니메이션합니다(비디오 요소는 절대 애니메이션하지 마세요 — <video> 크기를 애니메이션하면 프레임이 멈춥니다).
두 가지 모드:
const BOTTOM = { x: 0, y: 1136, scale: 0.5625 }; // 하단 절반, 전체 가로 보임
const FULLSCREEN = { x: -1166.5, y: 0, scale: 1.7778 }; // 잘린 커버, 1080x1920 채움
const MODE_DUR = 0.32;
BOTTOM은 1920x1080 소스를 1080x607.5로 렌더링하여 하단 960px 중앙에 배치합니다. FULLSCREEN은 가로로 잘라 세로 프레임을 채웁니다.
새 장면의 콘텐츠가 도착하기 0.15초 전에 전환하고, ease: "expo.inOut"을 사용하세요:
[
{ t: <scene-4-start>, mode: FULLSCREEN },
{ t: <scene-5-start>, mode: BOTTOM },
…
].forEach(({ t, mode }) => {
mainTl.to("#face-wrapper", { ...mode, duration: MODE_DUR, ease: "expo.inOut" }, t - 0.15);
});
얼굴 모드가 즉시 전환되는 것은 세로 비디오에서 가장 어색한 프레임입니다. 항상 보간하세요.
얼굴 보정 (모든 단편, 예외 없음)
#face-video {
filter: contrast(1.08) saturate(1.08) brightness(0.97);
}
전체 기간에 걸친 미묘한 1.00 → 1.025 Ken Burns 줌(ease: "none")과 측면 비네트 ::after 의사 요소를 추가하여 얼굴이 날카로운 가장자리와 부딪히지 않고 주변 네이비 색상에 자연스럽게 녹아들게 합니다.
이음새 처리 (하단 절반 장면에 필수)
y=960에 네이비 → 투명 그라데이션 밴드(60–100px)와 부드러운 광택이 있는 2px 강조 스캔 라인. 얼굴 위에 위치하도록 얼굴 다음에 그립니다. 전체 화면 장면이 덮을 때 이를 덮습니다. 날카로운 y=960 절단선은 AI 편집 콘텐츠의 두 번째 징후입니다(배경 평탄성 다음으로).
오디오 동기화 프로토콜 (건너뛰지 마세요)
문제: 오디오가 편집된 경우(재녹음/일시 중지 제거), 소스 트랜스크립트의 타임스탬프가 더 이상 편집된 비디오와 일치하지 않습니다. 원본 시간으로 작성된 장면 시작은 늦게 실행됩니다.
규칙: 모든 타이밍은 편집된 시간에 있습니다. 절대 혼용하지 마세요.
단편 비디오 리타임을 위한 검증 절차:
- 두 오디오 파일의 길이를 측정하세요:
차이 = 총 절단 시간.ffprobe -v error -show_entries format=duration -of csv=p=0 assets/original.mp4 ffprobe -v error -show_entries format=duration -of csv=p=0 assets/<name>-edit.mp4 captions.html에shift()함수를 사용하여 트랜스크립트 단어를 매핑하는 경우, 이를 진리로 취급하세요.shift(originalTime) = editedTime매핑은 모든 장면의data-start에도 적용됩니다.- 장면 내부 오프셋(
compositions/sceneN.html내부)은 장면의data-start기준 LOCAL입니다. 장면의 부모data-start가 편집된 시간에서 올바르면, 내부 오프셋은 수정 없이 올바르게 유지됩니다 — 단, 장면이 절단을 가로지르는 경우 제외하며, 이 경우 부모 길이와 내부 오프셋이 모두 변경됩니다. - 얼굴 모드 전환 배열 시간은 반드시 편집된 시간을 사용해야 합니다. 자동으로 변경되지 않습니다.
리타임 계획 형식 (매번 이 테이블 구조를 사용하세요):
| 장면 | 현재 시작 | 현재 길이 | 새 시작 | 새 길이 | 이유 |
|---|---|---|---|---|---|
| ... | ... | ... | ... | ... | ... |
그런 다음 얼굴 모드 배열, 내부 오프셋 변경 사항, 그 다음 프레임 검증 목록을 작성하세요.
장면 작성
하나의 장면 = 하나의 하위 구성 파일. 장면은 같은 data-track-index에 연속으로 배치됩니다(간격 없음). 각 장면 내부:
data-duration은 부모 슬롯과 정확히 일치합니다.- 모든 GSAP 앵커는 LOCAL입니다(장면 시작 기준 0부터).
tl.set({}, {}, <data-duration>)을 사용하여 타임라인을 패딩하여 GSAPtl.duration()이data-duration과 일치하도록 합니다.
장면 페이싱 규칙 (10가지 원칙에서)
- 데드 프레임 없음. 매 100ms마다 ≥1개 이상의 애니메이션 요소가 있습니다. 첫 진입은 0.1–0.3s 오프셋, t=0이 아닙니다.
- 페이오프 ≥ 1s 유지. 장면의 "큰 공개"(스탬프, 숫자 잠금, 펀치라인)는 화면에 ≥1s, 이상적으로 1.5s 동안 표시되어야 합니다. 총 시간이 아닌 공개 시간으로 장면을 예산하세요.
- 전체 기간 동안 모션. 4초 장면에서 진입 애니메이션이 로컬 2초까지 모두 완료되면, 두 번째 모션(밑줄 스윕, 체크 표시 팝, 카드의 주변 표류, 필의 작은 진동 광택)을 추가하세요. 죽은 페이싱 = 스와이프 아웃.
- 이즈를 다양화하세요. 장면당 최소 3개의 다른 이즈를 진입에 사용하세요.
- 실행 시간 5초당 하나의 놀라운 장면. 타이포그래피 슬램, 글리치/크로매틱 공개, 휩-팬, 오디오 동기 슬램. 이것들이 없으면 비디오는 "레이블이 붙은 얼굴 영상"으로 읽힙니다 — 정확하지만 잊혀집니다.
자막 (가라오케 스타일)
- Montserrat 900, 46–58px(1080 너비 기준), 100% 흰색 기본
- 활성 단어: scale-1.08 팝 + 강조 색상으로 변경 (
#37bdf8AIS의 경우, 브랜드에 맞게 조정) - 계층화된
text-shadow를 통한 획, 절대-webkit-text-stroke사용 금지 (Chromium 렌더링에서 일관성 없음) - rgba 배경 필을 제거하세요 — 획이 가독성을 유지합니다. 자막은 자막 트랙이 아닌 프레임 위의 그래피티처럼 느껴져야 합니다.
- 리타임의 경우
captions.html내의shift()함수를 사용하여 트랜스크립트 단어 타임스탬프 → 편집된 시간으로 매핑하세요. 이렇게 하면 트랜스크립트 JSON이 변경되지 않고 리타임이 기계적으로 이루어집니다.
전체 가라오케 구현은 /hyperframes 아래의 references/captions.md를 참조하세요. 요약: 단어별 <span> 요소( data-word-start 포함), 각 범위에 범위가 지정된 GSAP 트윈, 0.08–0.12s의 짧은 팝 지속 시간.
주변 배경 (절대 평평한 네이비로 배송하지 마세요)
최소한의 배경 스택:
- 방사형 그라데이션 기본 (중앙이 가장자리보다 15–20% 밝음)
- 애니메이션 노이즈/그레인 오버레이 (8–12% 불투명도)
- 4–8개의 표류 입자 점 또는 그리드 트레이스
- 미묘한 비네트
background: #07121c만으로는 디자인이 아닌 자리 표시자입니다. 기술/컨트롤룸 미학을 위해 feedback_techy_background_layers.md의 6레이어 스택(HUD 그리드가 비네트로 마스킹됨 + 회로 트레이스 + 펄스 노드 + 스캔 빔 + 원격 측정 티커 + 코너 모노 레이블)을 사용하세요.
오디오 반응성
- 헤드라인은 비트에 맞춰 3–6% 맥동합니다. 배경은 저음에 10–30%까지 갈 수 있습니다.
- 텍스트 반응성은 미묘하게 유지(3–6%)하여 자막이 읽기 쉽도록 하고, 배경은 더 강하게 밀 수 있습니다.
- 시드가 있는 오프라인 분석기(오디오 특성 트랙 사전 계산)를 사용하여 렌더링이 결정적이도록 하세요. 렌더링 경로에서
AnalyserNode를 사용하지 마세요 —Math.random()과 실시간 오디오 노드는 결정성을 깨뜨립니다.
전환
- 맛을 다양화하세요. 연속으로 두 개의 동일한 전환 유형이 없어야 합니다. 6번의 하드 컷이 연속되면 AI 편집의 첫 번째 징후입니다.
- 얼굴 모드 전환(
BOTTOM ↔ FULLSCREEN)은 장면 간 모드가 변경될 때 장면 전환 역할을 합니다. - 순수 오버레이 장면 간 전환의 경우 레지스트리에서 설치하세요:
push-up,flash-through-white,sdf-iris또는 전체 셰이더 전환 팩.npx hyperframes catalog --type block으로 탐색하세요.
검증 게이트 (필수 — 검증 없이 배송하지 마세요)
린트 통과 ≠ 디자인 작동. 단어 정확도 타임스탬프에서 프레임을 추출하고 모든 PNG를 READ할 때까지 단편 비디오 렌더링이 완료되었다고 보고하지 마세요.
1단계 — 드래프트 렌더링
cd video-projects/<slug>
npx hyperframes lint
npx hyperframes render --quality draft --output renders/<slug>-vN-draft.mp4
2단계 — 단어 정확도 프레임 추출
특정 시각적 요소가 화면에 표시되어야 하는 말한 단어에 해당하는 타임스탬프 8~15개를 선택하세요. 반올림 숫자나 장면 중간이 아닙니다. 정확한 단어여야 합니다.
mkdir -p renders/frames-vN
for pair in "<t>:<label>" "<t>:<label>" ...; do
t="${pair%%:*}"; label="${pair##*:}"
ffmpeg -y -ss "$t" -i renders/<slug>-vN-draft.mp4 \
-frames:v 1 -q:v 2 "renders/frames-vN/t${t}-${label}.png"
done
3단계 — 모든 PNG 읽기
모든 PNG에 대해 Read를 호출하여 이미지가 컨텍스트에 로드되도록 하세요. 파일 이름만 나열하지 마세요. 각 프레임에 대해 다음을 확인하세요:
- 예상 시각적 요소가 예상 시간에 화면에 표시됨(1초 늦지 않음, 빠르지 않음)
- 화자의 얼굴이 하단 절반 장면에서 잘리지 않음
- 전체 화면 vs 하단 절반 얼굴 모드가 해당 장면에 올바름
- 자막이 브랜드에 맞고, 읽기 쉬우며, 넘치지 않음
- 빈 프레임, 의도하지 않은 중복, 화면 밖 텍스트 없음
4단계 — 실패 시 수정 후 재검증. 절대 깨진 상태로 배송하지 마세요.
5단계 — 최종 렌더링
npx hyperframes render --quality standard --output renders/<slug>-vN.mp4
최종 렌더링에서 3~4개의 프레임을 스팟 체크하여(같은 타임스탬프, 다른 폴더 frames-vN-final/) 표준 품질 인코딩이 아무것도 변경하지 않았는지 확인하세요.
10가지 규칙 (품질 체크리스트 — 첫 번째 드래프트 전에 실행)
모든 단편 비디오 제작. 작성 중에 이 목록을 실행하고, 이후에는 실행하지 마세요.
- 데드 프레임 없음. 매 100ms마다 애니메이션 요소가 있습니다.
- 장면 페이오프 ≥ 1s 유지. 총 시간이 아닌 공개 시간으로 예산을 세우세요.
- 얼굴은 캐릭터입니다. 보정 + Ken Burns + 측면 비네트.
- 단단한 이음새 없음. y=960을 그라데이션 + 스캔 라인으로 깃털 처리하세요.
- 실행 시간 5초당 하나의 놀라운 장면. 타이포그래피 슬램, 글리치, 휩-팬, 오디오 슬램.
- 오디오 반응성은 협상 불가. 텍스트 3–6%, 배경 10–30%.
- 전환 맛을 다양화하세요. 연속으로 두 개의 동일한 유형이 없어야 합니다.
- 자막은 팝하며, 정중하게 레이블을 붙이지 않습니다. 획, 필이 아닙니다. 활성 단어에 스케일 + 색상.
- 전체 장면 기간 동안 모션. 진입이 일찍 끝나면 두 번째 모션을 추가하세요.
- 배경은 레이어이지 색상이 아닙니다. 최소 방사형 + 노이즈 + 입자 + 비네트.
- 슬램/스탬프 오버레이는 목표 텍스트가 완전히 보인 후에 나타납니다. 공개 로직 > 단어 동기화. 스탬프
t≥ 대상-가시t+ 0.10–0.25s. 그렇지 않으면 펀치라인이 설정 전에 나타납니다.
프로젝트 구조 (모든 단편 비디오 프로젝트)
video-projects/<slug>/
├── hyperframes.json
├── meta.json (id, name, dimensions 1080x1920, fps 30)
├── index.html (루트 구성, 4레이어 뼈대)
├── compositions/
│ ├── ambient-bg.html
│ ├── seam-treatment.html
│ ├── captions.html (리타임 시 shift() 함수 포함)
│ ├── scene1-<label>.html
│ ├── scene2-<label>.html
│ └── ...
├── assets/
│ ├── <name>.mp4 (원본 녹음)
│ ├── <name>-edit.mp4 (편집됨 — 절단 제거 — 구성이 사용하는 것)
│ ├── transcript.json (Whisper 출력)
│ └── 브랜드 자산 (로고, brand-tokens.css, 배경 음악)
└── renders/
├── <slug>-v1-draft.mp4
├── frames-v1/
├── <slug>-v1.mp4
└── ...
리타임 프로토콜 (오디오가 재편집되거나 타임스탬프가 변경될 때)
ffprobe로 이전 및 새 편집된 오디오 길이를 측정하세요. 델타 = 총 절단 시간.- 절단 창을 식별하세요: 어떤 초가, 어디서 제거되었는지.
- 계획 테이블을 작성하세요: 모든 장면
data-start,data-duration, 모든 얼굴 모드 전환t, 내부 오프셋이 절단을 가로지르는 장면. - 각 장면에 대해�