# 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）

2. 备选格式（用于不同情况）：
   - `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/` 前缀
   ```typescript
   // 正确方式
   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 脚本，可以：
- 测试多种可能的头像路径格式
- 显示所有成功加载的路径
- 自动在成功的头像之间切换显示