# 敌人音效系统使用指南

## 系统架构概述

敌人音效系统采用分层架构设计，确保清晰的依赖关系和良好的可维护性：

```
AudioManager (核心音频管理器)
    ↑
EnemyAudios (敌人专用音效管理器)
    ↑
EnemyInstance (敌人实例)
```

### 依赖关系说明

1. **AudioManager**: 核心音频管理器，提供基础的音频播放功能
2. **EnemyAudios**: 敌人专用音效管理器，封装敌人相关的音效逻辑
3. **EnemyInstance**: 敌人实例，在特定事件时调用音效播放

## 文件结构

- `AudioManager/AudioManager.ts` - 核心音频管理器
- `AudioManager/EnemyAudios.ts` - 敌人音效管理器
- `CombatSystem/EnemyInstance.ts` - 敌人实例（集成音效调用）
- `resources/data/enemies.json` - 敌人配置文件（包含音效配置）

## 音效配置

### enemies.json 配置格式

```json
{
  "enemyType": {
    "audioConfig": {
      "attackSound": "audio/enemy/attack1",
      "deathSound": "audio/enemy/death1",
      "hitSound": "audio/enemy/hit1",
      "walkSound": "audio/enemy/walk1"
    },
    "audio": {
      "attackSound": "enemy_attack_01",
      "deathSound": "enemy_death_01",
      "hitSound": "enemy_hit_01",
      "walkSound": "enemy_walk_01"
    }
  }
}
```

### 音效类型说明

- **attackSound**: 攻击音效
- **deathSound**: 死亡音效
- **hitSound**: 受击音效
- **walkSound**: 行走音效
- **specialSound**: 特殊技能音效（可选）

## 使用流程

### 1. 组件初始化

在Cocos Creator编辑器中：
1. 在Canvas/AudioManager节点上添加AudioManager组件
2. 在Canvas/AudioManager节点上添加EnemyAudios组件

### 2. 音效播放时机

音效会在以下时机自动播放：

- **攻击音效**: 当敌人执行攻击动作时（`performAttack`方法）
- **行走音效**: 当敌人播放行走动画时（`playWalkAnimation`方法）
- **受击音效**: 当敌人受到伤害时（`takeDamage`方法）
- **死亡音效**: 当敌人死亡时（`playDeathAnimationAndDestroy`方法）

### 3. 音效播放逻辑

```typescript
// 在EnemyInstance中的使用示例
import { EnemyAudio } from "../../AudioManager/EnemyAudios";

// 攻击时播放音效
performAttack() {
    EnemyAudio.playAttack(this.enemyConfig);
    // ... 其他攻击逻辑
}

// 受击时播放音效
takeDamage(damage: number) {
    EnemyAudio.playHit(this.enemyConfig);
    // ... 其他受击逻辑
}
```

## 音效管理特性

### 1. 配置优先级

音效路径获取优先级：
1. `audioConfig` 中的路径（优先）
2. `audio` 中的标识符
3. 默认音效路径（兜底）

### 2. 音量控制

- 所有敌人音效统一使用音效音量设置
- 通过AudioManager的音效音量控制
- 支持静音功能

### 3. 错误处理

- 当音效文件不存在时，会使用默认音效
- 当配置缺失时，会跳过音效播放
- 所有错误都会在控制台输出警告信息

## 最佳实践

### 1. 音效文件管理

- 将音效文件放在`resources/audio/enemy/`目录下
- 使用统一的命名规范：`{enemyType}_{soundType}_{variant}`
- 例如：`goblin_attack_01.mp3`

### 2. 配置管理

- 在`enemies.json`中为每个敌人类型配置完整的音效
- 使用相对路径，不包含文件扩展名
- 保持配置的一致性和完整性

### 3. 性能优化

- 音效文件大小控制在合理范围内
- 避免在短时间内重复播放相同音效
- 使用音效池管理频繁播放的音效

### 4. 扩展性考虑

- 新增音效类型时，在EnemyAudios中添加对应方法
- 在enemies.json中添加新的音效配置字段
- 在EnemyInstance中的适当位置调用新音效

## 故障排除

### 常见问题

1. **音效不播放**
   - 检查AudioManager组件是否正确挂载
   - 检查音效文件路径是否正确
   - 检查音效音量是否为0或静音

2. **音效路径错误**
   - 检查enemies.json中的配置是否正确
   - 确认音效文件是否存在于resources目录中

3. **循环引用错误**
   - 确保依赖关系为单向：AudioManager ← EnemyAudios ← EnemyInstance
   - 避免在AudioManager中引用EnemyInstance相关代码

### 调试技巧

- 在EnemyAudios中添加日志输出，跟踪音效播放状态
- 使用Cocos Creator的音频调试工具
- 检查浏览器控制台的错误信息

## 总结

敌人音效系统通过清晰的分层架构和配置驱动的方式，实现了灵活、可维护的音效管理。系统避免了循环依赖，确保了代码的清晰性和可扩展性。通过合理的配置和使用，可以为游戏提供丰富的音效体验。