用途 该技能用于把 GSAP(GreenSock)动画与 Helios 时间线结合,使 GSAP 动画可由 Helios 的帧状态驱动,从而支持擦洗、暂停和逐帧渲染。
主要能力 提供“暂停时间线”(Paused Timeline)集成模式:创建暂停的 GSAP Timeline,订阅 Helios 更新,将 Helios 当前帧换算为秒,再调用 timeline.seek(seconds) 同步。文档还给出可直接参考的示例代码,演示初始化 Helios、定义动画、订阅同步以及绑定预览的完整流程。
使用方式 基本步骤如下:1)用 @helios-project/core 初始化 Helios,设置 fps 与时长;2)以 { paused: true } 创建 GSAP Timeline 并定义动画;3)通过 helios.subscribe 获取状态,用 state.currentFrame / helios.fps 得到秒数并 seek;4)调用 helios.bindToDocumentTimeline() 绑定预览,并把实例挂到 window 便于调试。文档同时列出关键规则:GSAP 时间线必须暂停;优先使用 seek(seconds) 而非 progress();不要自建 requestAnimationFrame 循环,交由 Helios 驱动更新。源代码示例位于 examples/gsap-animation/。
适用场景 适合需要在 Helios 渲染流程中精确控制 GSAP 动画播放位置、实现帧级同步预览与输出的开发场景。
限制 资料仅说明集成模式与关键规则,未提供性能数据、兼容范围或完整 API 说明。