이 브리지를 위한 HyperFrames 저작 참조
이 간결한 참조는 하네스를 위해 작성되었습니다. 전체 제품 가이드는 설치된 데스크톱 앱과 공식 HyperFrames 문서에 있습니다.
구성
독립형 index.html은 body에 직접 구성 루트를 가집니다. data-composition-id, data-width, data-height 및 유한한 data-duration을 사용하십시오. 루트의 CSS width/height는 100%입니다. 캔버스 크기는 해당 data 속성에 속합니다. 서브 컴포지션은 내부에 스타일/스크립트가 포함된 템플릿을 사용합니다.
클립에는 class="clip", 의도적인 data-start/data-duration 및 data-track-index를 부여하십시오. 트랙은 Studio 레인으로, 타이밍 제약 조건이나 z-index가 아닙니다. 루트 기간은 모든 의도된 클립의 끝을 포함해야 합니다. 편집 시 관련 없는 타이밍, 식별자 및 미디어를 보존하십시오.
window.__timelines[compositionId]에 하나의 일시 중지된 GSAP 타임라인을 등록하되, 루트와 동일한 ID를 사용하십시오. 내부 요소를 애니메이션화하고, 프레임워크가 클립 가시성 및 미디어 탐색을 제어합니다. 클립의 display, visibility 또는 autoAlpha를 애니메이션화하지 마십시오. CSS-transform/GSAP 충돌, 클록, 타이머, 시드되지 않은 랜덤 및 네트워크 의존적 애니메이션 상태를 피하십시오.
로컬에서 재현 가능한 미디어를 사용하십시오. 모든 오디오 요소는 고유 ID와 의도적인 타이밍이 필요합니다. 미디어에 crossorigin을 사용하지 말고, data-start가 있는 비디오 주위에 중첩된 시간 조상(nested timed ancestors)을 두지 마십시오. 파일 경로는 실제 프로젝트 에셋과 일치해야 합니다.
워크플로
편집 전에 관련 파일과 앱의 필수 가이드를 읽으십시오. 사용자 요청의 범위와 일치시켜야 합니다. 사용할 수 없는 MCP 도구나 셸 명령을 실행한다고 주장하지 마십시오. 브리지는 lint, check, timeline, inspect라는 명명된 명령을 제공합니다.
의미 있는 명명된 검사를 실행하고, 실제 종료 상태와 결과를 보고하며, 관련 없는 작업을 보존하십시오. lint 오류는 런타임/레이아웃/대비 감사가 실행되는 것을 방해할 수 있습니다. 샘플이 0개인 것은 성공적인 시각적 검증을 입증하지 못합니다. lint 통과가 시각적 품질의 증거는 아닙니다.
사용자가 내보내기를 요청하고 app_rules에서 허용하는 경우에만 렌더링하십시오. 종료 상태에 도달할 때까지 render_status를 폴링하고, 완료되지 않은 내보내기가 성공했다고 주장하지 마십시오. 데스크톱 앱이 자체적으로 내보내기를 소유할 수 있으며, 이 경우 해당 app_rules를 따르십시오.
오디오 에셋
로컬에서 활성화되고 요청된 경우, list_voices는 사용자의 사용 가능한 음성 ID를 반환합니다. create_speech 및 create_sound_effect는 실제 프로젝트 상대 경로의 MP3 파일을 반환합니다. 컴포지션에서 반환된 경로를 고유한 오디오 ID와 적절한 타이밍과 함께 사용하십시오. 생성이 실패하면 실패를 보고하고 에셋을 임의로 만들거나 자동으로 재시도하지 마십시오.
음성 및 음향 효과는 사용자 자신의 키로 이루어지는 제품 API 호출입니다. 스크립트/설명은 ElevenLabs로 전송되며 생성 시 크레딧이 소모될 수 있습니다. 채팅은 텍스트 전용으로 유지됩니다. 음악 및 이미지/비디오 생성은 이 버전에서 제공되지 않습니다.