aibis-dream/Docs/独立FrameClip播放器与编辑器验收.md

独立 FrameClip 播放器与编辑器验收

独立播放器

1. 创建带 SpriteRenderer 或 Image 的对象并添加 FrameClipPlayer。
2. 绑定一个有效的外部 FrameClip，启用 Play On Enable 后进入 Play Mode。
3. 确认首帧立即显示，速度、Loop、HoldLastFrame、Clear、HideTarget 与 Graph Player 一致。
4. 在代码中调用 Play(otherClip)，确认临时 Clip 播放但 Inspector 默认 Clip 不变。
5. 同对象同时添加 FrameAnimationPlayer，确认 Inspector 报错且播放返回 TargetConflict。

独立 Clip 编辑器

1. 双击外部 FrameClip.asset，确认打开 Frame Clip Editor；Graph sub-asset 仍打开 Graph Editor。
2. 手工编辑 ID、Display Name、Speed、Default End 和帧列表，检查预览、拖动时间和逐帧按钮。
3. 为外部 Clip 启用 Texture + JSON Source，指定 Texture、Aseprite JSON、Pivot，并按需启用切图管理。
4. 点击 Preview Import 检查差异，再点击 Refresh；若需要修改 TextureImporter，应先出现确认框。
5. 多 Tag JSON 只应采用数组中第一个 Tag；无 Tag JSON 应采用全部 frames。
6. 来源型 Clip 的帧列表必须只读；点击 Detach Source 后保留当前帧并恢复手工编辑。
7. 将来源型外部 Clip 加入 Graph，确认可以创建节点和播放，但刷新入口仍位于独立 Clip 编辑器。

安全检查

• 同一 Texture 只能有一个启用了切图管理的 Graph ImportSource 或独立 Clip 来源。
• 空 ID 在首次刷新时由首 Tag 名初始化；无 Tag 时使用资产文件名。
• 已有 ID 和 Display Name 在后续刷新时不自动改变。
• 被多个 Graph 共享的外部 Clip 不能在独立编辑器中重命名 ID。