SuperAPI AI 工具集

hyperframes-core

设计与创作

查看项目

更新于 10-19 17:58

技能介绍

HyperFrames Core 是 HyperFrames 工具链中的技术契约技能,目标是指导构建一个可渲染的 HyperFrames 项目。HyperFrames 从 HTML 生成视频:一个合成就是一个 HTML 文件,其 DOM 通过 data-* 属性声明时间信息,动画运行时支持跳转(seek),媒体播放由框架负责。

主要能力与覆盖范围:该技能本体是构建指南,按主题的细节放在 references/ 目录中按需阅读,包括最小可渲染合成骨架、单体与模块化合成模式选择、data-* 属性查询(根元素、clip、子合成宿主及旧别名)、轨道与剪辑(data-track-index 与 z-index、相对时间、用 npx hyperframes timeline 列出全部轨道与剪辑)、剪辑编辑配方(剪切、裁剪、重排、改时、冻结、镜头、遮罩、交叉淡化、音频)、子合成接线(宿主属性、<template>、每实例变量)、变量与媒体(声明变量、放置 video/audio、设置音量与裁剪)、确定性规则(可 seek 时间轴、确定性禁令、布局与文本适配)、全屏动效、Tailwind v4 项目适配等。动画运行时细节(GSAP API、Lottie、Three.js 等)属于 hyperframes-animation 技能的适配器文档。

使用方式:合成有两种根形式且不可互换——独立形式(顶层 index.html,根 <div data-composition-id="…"> 直接位于 <body>,不能包 <template>)与子合成形式(通过 data-composition-src 加载,根包在 <template> 中)。根节点需设置宽高(独立根用 width/height:100%,画布尺寸由 data-width/data-height 决定,不要在 #root 上硬编码 1920px/1080px)。每个合成在 window.__timelines["<id>"] 注册恰好一个 gsap.timeline({ paused: true }),键名与根 data-composition-id 一致;渲染长度由根的 data-duration 决定。编辑已有合成时应先读文件,保留无关的时间、轨道、ID、变量与媒体路径,可用 npx hyperframes timeline 查看时间轴。

常见陷阱:不要在节点上同时使用 CSS 初始 transform 与 GSAP 对同一属性的 tween(用 fromTo 或 xPercent/yPercent 代替);不要在 <video>/<audio> 上加 crossorigin;不要让 <video data-start> 的祖先元素也带 data-start;每个 <audio> 必须有 id;不要对 .clip 元素 tween autoAlpha 或 visibility;命名 CSS 字体需要文件内 @font-face 指向本地文件;子合成 #root 用 100% 而非硬编码像素。lint 错误会同时关闭布局与对比度审计,需先清除错误。

适用场景:需要以代码方式制作可复现、可精确 seek 的 HTML 转视频合成,包括多轨剪辑、子合成嵌套、变量与媒体控制等。限制与未提供信息:具体平台支持、收费、性能基准等文档未提供;更多流程文档(brief、storyboard、review、production、dispatch、frame-worker)位于 /hyperframes 的 references/ 中。