# 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 淡入淡出或权重插值。