用途:该技能给出 Helios 与 GSAP(GreenSock)集成的模式,用于把 GSAP 时间轴交给 Helios 的时间轴统一驱动,从而支持精确拖动(scrubbing)与逐帧渲染。
主要能力与用法:核心是“暂停时间轴”模式。先用 @helios-project/core 创建 Helios 实例并设置 fps 与 durationInSeconds;再用 gsap.timeline({ paused: true }) 创建暂停的 GSAP 时间轴,并在其中定义动画(示例包含 rotation、x、scale 等补间)。随后通过 helios.subscribe 订阅状态更新,在回调中把当前帧换算成秒(state.currentFrame / helios.fps),调用 tl.seek(seconds) 同步。最后用 helios.bindToDocumentTimeline() 绑定预览,并把实例挂到 window.helios。
关键规则:GSAP 时间轴必须以 { paused: true } 初始化,否则会自行播放并与 Helios 争夺控制权;应使用 tl.seek(seconds),除非自行计算 0-1 归一化值,否则不要用 tl.progress();不要为 GSAP 自建 requestAnimationFrame 循环,更新应由 Helios 的 subscribe 驱动。
适用场景:需要在 Helios 时间轴上精确控制 GSAP 动画播放位置、逐帧渲染或拖动预览的前端场景。
限制:资料仅提供上述集成模式与示例目录 examples/gsap-animation/,未说明支持平台、版本要求、收费、性能表现或其他进阶用法,这些方面暂未提供。