HyperFrames 핵심 — 합성 계약은(는) 무엇을 하나요?
HTML 골격
<!DOCTYPE html>
<html data-hf-version="1">
<head>
<meta charset="UTF-8" />
<meta name="hf:canvas-width" content="1920" />
<meta name="hf:canvas-height" content="1080" />
<meta name="hf:fps" content="30" />
<meta name="hf:duration" content="auto" />
</head>
<body>
<div data-hf-scene="intro" data-hf-duration="5s">
<div data-hf-track="background">
<div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
style="background:#111;width:100%;height:100%;position:absolute;"></div>
</div>
<div data-hf-track="title">
<div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
data-hf-animate="fade-in">
<h1>Hello World</h1>
</div>
</div>
</div>
</body>
</html>
캔버스 메타 태그
| 태그 | 기본값 | 참고 |
|---|
hf:canvas-width | 1920 | 픽셀 |
hf:canvas-height | 1080 | 픽셀 |
hf:fps | 30 | 초당 프레임 |
hf:duration | auto | 전체 재생 시간; 명시적 지정 가능 (예: 60s) |
hf:bg-color | #000 | 기본 씬 배경 |
씬 속성 (data-hf-scene)
| 속성 | 타입 | 설명 |
|---|
data-hf-scene | 문자열 | 씬 이름/ID |
data-hf-duration | 시간 | 5s, 10s, auto |
data-hf-transition | 문자열 | cut, fade, slide-left, slide-right, zoom |
data-hf-transition-duration | 시간 | 기본값 0.5s |
data-hf-bg | URL 또는 색상 | 씬 배경 |
트랙 속성 (data-hf-track)
| 속성 | 타입 | 설명 |
|---|
data-hf-track | 문자열 | 트랙 이름 |
data-hf-z | 숫자 | z-index 쌓임 순서 |
data-hf-mute | 불리언 | 이 트랙 오디오 음소거 |
클립 속성 (data-hf-clip)
| 속성 | 타입 | 설명 |
|---|
data-hf-clip | — | 요소를 클립으로 표시 |
data-hf-start | 시간 | 씬 내 시작 오프셋 |
data-hf-duration | 시간 | 클립 재생 시간; auto = 콘텐츠 재생 시간 |
data-hf-end | 시간 | duration 대신 사용 가능 |
data-hf-animate | 문자열 | 단축 애니메이션 프리셋 |
data-hf-in | 문자열 | 진입 애니메이션 |
data-hf-out | 문자열 | 퇴장 애니메이션 |
data-hf-volume | 0–1 | 오디오 볼륨 |
data-hf-speed | 숫자 | 재생 속도 배수 |
data-hf-loop | 불리언 | 미디어 반복 재생 |
data-hf-trim-start | 시간 | 미디어 시작 부분 자르기 |
data-hf-trim-end | 시간 | 미디어 끝 부분 자르기 |
미디어 클립
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />
<div data-hf-clip data-hf-tts="Hello, welcome to the demo." data-hf-start="1s" />
시간 형식
모든 시간 값은 CSS 스타일 표기법(0s, 1.5s, 2000ms)을 사용합니다. 소수 초도 허용됩니다.
유효성 검사
npx hyperframes lint index.html