GSAP 集成模式
要结合 GSAP 与 Helios 使用,必须使用 Helios 帧状态驱动 GSAP 时间线实例。这样可以让 GSAP 动画被擦除、暂停和逐帧渲染。
快速开始
“暂停时间线”模式
- 创建
paused: true的 GSAP 时间线。 - 订阅 Helios 更新。
- 在订阅函数中,将 Helios 帧转换为秒。
- 调用
timeline.seek(seconds)进行同步。
<script type="module">
import { Helios } from '@helios-project/core';
import { gsap } from 'gsap';
// 1. 初始化 Helios
const helios = new Helios({
fps: 30,
durationInSeconds: 5,
});
// 2. 设置 GSAP 时间线(必须 PAUSED)
const tl = gsap.timeline({ paused: true });
// 3. 定义动画
tl.to(".box", {
rotation: 360,
x: 100,
duration: 2,
ease: "power1.inOut"
})
.to(".box", {
scale: 2,
duration: 2
});
// 4. 订阅并同步
helios.subscribe((state) => {
// 将帧计数转换为秒
const timeInSeconds = state.currentFrame / helios.fps;
// 将 GSAP 移动到精确时间点
tl.seek(timeInSeconds);
});
// 5. 绑定预览
helios.bindToDocumentTimeline();
window.helios = helios;
</script>
关键规则
- 始终暂停: GSAP 时间线必须使用
{ paused: true }初始化。如果它自动播放,会与 Helios 争夺控制权。 - 使用 Seek: 除非你计算了归一化的 0-1 值,否则不要使用
tl.progress()。由于 Helios 知道 FPS 和帧数,tl.seek(seconds)通常更直接。 - 不要使用
requestAnimationFrame: 不要为 GSAP 创建自己的 rAF 循环。让 Helios 通过subscribe驱动更新。
源文件
- 示例:
examples/gsap-animation/