aibis-dream/Docs/FrameAnimationTimeline使用说明.md

FrameAnimation Timeline 使用说明

创建与绑定

1. 为带有 SpriteRenderer 或 UI Image 的对象添加 FrameClipPlayer。
2. 在 Timeline 中创建 Frame Animation Track。
3. 将场景中的 FrameClipPlayer 绑定到轨道。
4. 在轨道上创建 Frame Animation Clip，并在 Inspector 中指定独立的 FrameClip.asset。

Timeline Clip 的初始时长来自 FrameClip 的帧总时长和 Speed。Clip 支持裁剪、Clip In、Timeline Speed Multiplier，以及在编辑模式下拖动时间轴预览。

循环与终态

• Loop：延长 Timeline Clip 后在 Clip 范围内循环；离开 Clip 后保持最后采样帧。
• HoldLastFrame：Clip 结束或 Director 停止后保持最后一帧。
• Clear：Clip 结束后清空 Sprite，并保持显示组件启用。
• HideTarget：Clip 结束后禁用 SpriteRenderer 或 Image。

同一轨道不提供 Sprite 混合。Clip 重叠时，开始时间更晚的 Clip 优先。关闭 Timeline 编辑态预览后，Unity 会恢复预览前的 Sprite 与显示状态。

第一版边界

• Timeline Clip 只引用独立 FrameClip，不播放 FrameAnimationGraph 或 AnimationFlow。
• 不支持多条轨道同时控制同一个 FrameClipPlayer。
• 不支持 Sprite 淡入淡出或权重插值。