docs(frame-animation): 补充共享 Sprite 与 Actor 接入文档

This commit is contained in:
2026-07-17 20:20:16 +08:00
parent a4620dacc8
commit 1077bc551c
3 changed files with 79 additions and 0 deletions
@@ -296,6 +296,30 @@
- rect/pivot 更新为 JSON 和 ImportSource 设置。
- JSON 中消失的 frameName 对应旧 SpriteRect仍保留。
### IMP-08A 合并帧共享 SpriteP0
操作:
1. 使用包含多个 SourceFrame 指向相同 `frame.x/y/w/h` 的 Aseprite JSON。
2. 确认来源设置为 `manageSpriteSlicing = true`,点击 `Preview Source`
3. 检查来源摘要中的逻辑帧、SpriteSlot 和共享别名数量。
4. 确认刷新后检查对应 Imported Clip 的帧表和 Sprite引用。
5. 再次执行 Preview 和 Refresh。
佩佩素材的预期统计:
- 347 个逻辑 SourceFrame。
- 205 个唯一 SpriteSlot。
- 142 个共享别名。
预期:
- 相同 rect 只创建一个有效 SpriteRect。
- 不同 SourceFrame仍保留各自的 frameName、sourceIndex、duration 和 Tag顺序。
- 指向同一 rect 的 Clip Frame直接引用同一个 Unity Sprite。
- 第二次 Preview 中 SpriteSlot 和 Clip均显示 UnchangedSprite ID保持稳定。
- 原始 PNG 和 JSON不被修改。
### IMP-09 多写入所有者冲突(P0)
操作:
@@ -409,6 +433,7 @@
- 用户拥有字段不会被刷新覆盖。
- 只读来源绝不修改 TextureImporter。
- 自动切图为同名 frameName 保留稳定 Sprite ID。
- 合并帧只创建唯一 SpriteSlot,同时保留全部逻辑帧时长与播放顺序。
- 多写入所有者、素材错误和命名冲突能够阻断刷新。
- 单来源和全部来源刷新都不产生部分 Graph/Clip 更新。
- 保存、Undo/Redo 和重新打开 Unity 后资产引用保持稳定。