game009_weiren

FakeHuman - Avatar Loading Documentation

角色头像加载

本项目使用 Cocos Creator 加载并显示角色头像。头像文件存储在 assets/resources 目录下，有以下几种格式：

头像文件路径格式

1. 主要格式（通行证头像）：

   assets/resources/avatars/{characterId}/avatar_{characterId}.{variant}.png
   

例如：avatars/1/avatar_1.5.png

其中：

• {characterId} 是角色ID（数字）
• {variant} 是头像变体（1-5）

1. 备选格式（用于不同情况）：
   • assets/resources/0{characterId}/{characterId}.png - 人物资源路径
   • assets/resources/avatars/{characterId}/{characterId}.png - 简化头像路径
   • assets/resources/avatars/{characterId}.png - 直接ID路径
   • assets/resources/{characterId}.png - 根资源路径

重要说明

1. 资源加载路径：使用 resources.load() 加载资源时，不需要包含 .png 后缀和 assets/resources/ 前缀

   // 正确方式
   resources.load(`avatars/1/avatar_1.5`, SpriteFrame, callback);
      
   // 错误方式
   resources.load(`assets/resources/avatars/1/avatar_1.5.png`, SpriteFrame, callback);
   

2. 路径尝试顺序：如果主要路径加载失败，系统会自动尝试备选路径格式

相关组件

1. PassCardManager: 通行证管理器，负责显示角色通行证和头像
2. SimpleAvatarTest: 测试工具，用于测试和诊断头像加载问题
3. QuestionAnswerManager: 问答管理器，处理显示通行证的交互逻辑

排查头像加载问题

如果头像无法正常显示，请检查：

1. 确认资源文件存在并位于正确的目录
2. 检查控制台日志中的路径加载错误
3. 使用 SimpleAvatarTest 组件测试不同的加载路径
4. 确认 characterId 参数正确传递给 PassCardManager

调试工具

项目提供了 SimpleAvatarTest 脚本，可以：

• 测试多种可能的头像路径格式
• 显示所有成功加载的路径
• 自动在成功的头像之间切换显示