game009_weiren/SimpleCharacterView.md

SimpleCharacterView 测试场景设置指南

场景创建

1. 在 Cocos Creator 中，创建一个新场景，命名为 SimpleCharacterTestScene
2. 保存到 assets/Scenes/ 目录

场景结构

构建以下节点层级：

Canvas
├── StatusLabel        (Label组件)
├── Character1         (含Sprite组件)
├── Character2         (含Sprite组件)
├── Character3         (含Sprite组件)
├── Character4         (含Sprite组件)
└── Controller         (添加SimpleCharacterView组件)

详细设置步骤

1. 创建基本节点

• 创建 Canvas 节点（场景自带）
• 添加 StatusLabel 节点，添加 Label 组件
• 添加 4个角色节点（Character1-4），每个添加 Sprite 组件
• 添加 Controller 节点，用于挂载脚本

2. 设置 Sprite 组件

对于每个角色节点:

• 添加 Sprite 组件
• 可以将尺寸设置为合适大小，如 200x200
• 排列节点位置，让它们均匀分布在画面上

3. 设置 SimpleCharacterView 组件

将 SimpleCharacterView.ts 脚本添加到 Controller 节点，并设置：

• avatarSprite1-4: 拖拽对应的4个Sprite组件
• statusLabel: 拖拽StatusLabel的Label组件
• 设置角色ID：
  • characterId1: 1
  • characterId2: 3
  • characterId3: 5
  • characterId4: 7
• avatarVariant: 5 (对应 avatar_X.5)

运行测试

运行场景后，SimpleCharacterView 将自动：

1. 尝试为每个指定的角色ID加载头像
2. 如果主要路径失败，尝试备用路径
3. 在状态标签中显示加载进度
4. 在控制台输出详细的加载信息

故障排除

如果头像显示不出来，检查：

1. 控制台日志，查看具体的加载错误
2. 资源路径是否正确 (avatars/X/avatar_X.5)
3. 资源文件是否存在于相应的目录
4. Sprite 组件是否正确引用

优点

这个简化的实现完全避免了数组类型属性，直接使用4个独立的Sprite和ID设置，解决了Cocos Creator 3.8.6中数组类型引起的错误问题。