两个角色同名 run 后串动画：全局动画键命名

本文由 FrameSprite 作者工作流整理，AI 辅助编写，引用原始技术资料；构造案例不代表模型或引擎实测。

两个角色都创建 run 后串动作，区分动画定义键、纹理键和帧名。

简要答案

Phaser AnimationManager 的全局动画定义不能靠人物各自的 run 名称自动隔离。使用角色、动作与版本组成的稳定键，例如 witch/run/v2；纹理键和图集帧名仍需要单独记录。重复键是注册问题，不应通过改图片文件名碰运气。

适用范围

• 同一游戏加载多个角色或皮肤的相同动作。

不适用范围

• 把显示给玩家的动作名称直接当作全局唯一键。

1. 列出命名空间

分别记录动画键、纹理键、帧名。三个空间不要混为一个字符串。

2. 建立稳定键

采用角色标识、动作与版本，不使用数组位置作为身份。

3. 检查注册冲突

注册前查看定义是否存在，核对已有定义的实际来源。

4. 同时播放验收

两个角色同时 run、attack，确认各自引用的纹理与帧列表。

原创构造样本：四个动作键

比较两个人物都使用 run/attack 与带人物前缀的键。

无前缀四项只有两个唯一键；带前缀四项互不冲突。

仅检查字符串唯一性，不执行动画注册。

命名示例

纹理不同，动画键也必须明确归属

给 hero 和 guard 各创建 idle 与 run，直接使用 idle、run 只有 2 个唯一键；使用 hero:idle、hero:run、guard:idle、guard:run 才有 4 个。纹理缓存键不同并不能自动让全局动画键独立。把角色标识、动作标识与版本约定记录在清单里，创建前检测同名键是否已经存在。动作参数复用可以通过配置实现，但最终引用的帧仍要属于正确纹理。出现串图时，先打印动画键与纹理键，避免误以为 AI 生成了另一个人物。

• 验收：动画键
• 验收：纹理键
• 验收：创建与重复注册

版本更新也要可追踪

复刻动作或重新生成角色后，可保留旧版本键直到使用者完成切换，避免把已有对象静默指向新资源。发布清单应包含人物、纹理与动作定义版本。键名解决资源身份，不证明新旧动作具有相同帧数、节奏或命中窗口。

编辑与示例说明

本次补充由 AI 辅助整理，按公开原始技术资料核对。可下载的输入与预期结果是原创构造案例，不代表模型或引擎实测；实际项目应按步骤保留自己的验收记录。

常见问题

动画键与纹理键可以同名吗？

不同空间可以同名，但清单仍应分开，避免调试混淆。

每个 Sprite 都创建 run 就能隔离吗？

使用全局管理器时不能这样假定，核对定义作用域。

来源与补充材料

AnimationManager · Phaser

原文：https://cn.framesprite.com/guides/phaser-global-animation-key-character-namespace