# 统一音频系统使用指南

## 系统概述

统一音频系统是一个完整的游戏音频管理解决方案，支持背景音乐、UI音效、敌人音效、环境音效和武器音效的分类管理。该系统提供了灵活的配置、独立的音量控制和便捷的静态访问接口。

## 系统架构

```
AudioManager (核心管理器)
    ├── 背景音乐管理 (Music)
    ├── UI音效管理 (UI Sounds)
    ├── 敌人音效管理 (Enemy Sounds) ← EnemyAudios
    ├── 环境音效管理 (Environment Sounds)
    └── 武器音效管理 (Weapon Sounds)

AudioConfig (配置管理)
    └── 统一音频资源配置
```

### 依赖关系
- **AudioManager**: 核心音频管理器，提供分类音频播放和音量控制
- **AudioConfig**: 音频配置管理器，统一管理所有音频资源配置
- **EnemyAudios**: 敌人音效专用管理器，基于enemies.json配置
- **Audio**: 静态访问接口，提供便捷的全局音频操作方法

## 文件结构

```
assets/scripts/AudioManager/
├── AudioManager.ts        # 核心音频管理器
├── AudioConfig.ts         # 音频配置管理
├── EnemyAudios.ts         # 敌人音效管理器
└── SoundController.ts     # 音频控制器（UI相关）
```

## 音频分类

### 1. 背景音乐 (Music)
- **用途**: 游戏背景音乐
- **特点**: 通常循环播放，音量较低
- **示例**: 主菜单音乐、游戏内背景音乐、胜利/失败音乐

### 2. UI音效 (UI Sounds)
- **用途**: 用户界面交互音效
- **特点**: 短促、清脆，提供即时反馈
- **示例**: 按钮点击、菜单切换、提示音

### 3. 敌人音效 (Enemy Sounds)
- **用途**: 敌人相关的所有音效
- **特点**: 基于敌人类型动态配置
- **示例**: 攻击声、死亡声、受击声、行走声

### 4. 环境音效 (Environment Sounds)
- **用途**: 游戏环境和氛围音效
- **特点**: 增强游戏沉浸感
- **示例**: 风声、爆炸声、脚步声

### 5. 武器音效 (Weapon Sounds)
- **用途**: 武器相关音效
- **特点**: 动作反馈，增强打击感
- **示例**: 射击声、装弹声、切换武器声

## 使用方法

### 1. 基础音频播放

```typescript
// 播放背景音乐
Audio.playMusic('audio/music/game_background', true);

// 播放UI音效
Audio.playUISound('audio/ui/button_click');

// 播放敌人音效
Audio.playEnemySound('audio/enemy/goblin_attack');

// 播放环境音效
Audio.playEnvironmentSound('audio/environment/explosion');

// 播放武器音效
Audio.playWeaponSound('audio/weapon/gun_shot');
```

### 2. 音量控制

```typescript
// 设置音乐音量
Audio.setMusicVolume(0.6);

// 设置UI音效音量
Audio.setUISoundVolume(0.8);

// 设置敌人音效音量
Audio.setEnemySoundVolume(0.7);

// 设置所有音效音量
Audio.setAllSoundVolume(0.5);

// 静音所有音频
Audio.muteAll();

// 只静音音效，保留音乐
Audio.muteAllSounds();
```

### 3. 敌人音效专用接口

```typescript
// 播放特定敌人的音效
EnemyAudio.playAttackSound('goblin');
EnemyAudio.playDeathSound('orc');
EnemyAudio.playHitSound('skeleton');
EnemyAudio.playWalkSound('zombie');
EnemyAudio.playSpecialSound('boss');
```

### 4. 直接使用AudioManager

```typescript
const audioManager = AudioManager.getInstance();

// 播放分类音效
audioManager.playUISound('audio/ui/button_click');
audioManager.playEnemySound('audio/enemy/attack');

// 音量控制
audioManager.setUISoundVolume(0.8);
audioManager.setEnemySoundVolume(0.7);
```

## 配置管理

### 音频配置文件 (AudioConfig.ts)

```typescript
// 获取音频配置
const config = AudioConfig.getAudioConfig('audio/ui/button_click');

// 获取分类配置
const uiCategory = AudioConfig.getCategoryConfig(AudioType.UI_SOUND);

// 获取默认音量
const defaultVolume = AudioConfig.getDefaultVolume(AudioType.ENEMY_SOUND);

// 验证音频路径
const isValid = AudioConfig.isValidAudioPath('audio/music/background');
```

### 配置助手类

```typescript
// 快速访问各类音频配置
const musicList = AudioConfigHelper.music;
const uiSounds = AudioConfigHelper.uiSounds;
const enemySounds = AudioConfigHelper.enemySounds;
```

## 敌人音效配置

敌人音效通过 `enemies.json` 文件进行配置：

```json
{
  "goblin": {
    "audioConfig": {
      "attack": "audio/enemy/goblin/attack",
      "death": "audio/enemy/goblin/death",
      "hit": "audio/enemy/goblin/hit",
      "walk": "audio/enemy/goblin/walk"
    }
  }
}
```

## 组件挂载

### AudioManager 挂载
1. 在场景中创建 `Canvas/AudioManager` 节点
2. 添加 `AudioManager` 组件
3. 系统会自动创建各类音频源节点

### EnemyAudios 挂载
1. `EnemyAudios` 作为 `AudioManager` 的子模块
2. 通过单例模式访问，无需手动挂载
3. 自动初始化并加载敌人音频配置

## 最佳实践

### 1. 音频文件组织
```
assets/audio/
├── music/              # 背景音乐
│   ├── main_menu.mp3
│   └── game_background.mp3
├── ui/                 # UI音效
│   ├── button_click.wav
│   └── menu_open.wav
├── enemy/              # 敌人音效
│   ├── goblin/
│   └── orc/
├── environment/        # 环境音效
│   └── explosion.wav
└── weapon/             # 武器音效
    └── gun_shot.wav
```

### 2. 性能优化
- 使用合适的音频格式（WAV用于短音效，MP3用于长音乐）
- 控制同时播放的音效数量
- 及时释放不需要的音频资源

### 3. 音量平衡
- 背景音乐: 0.4-0.6
- UI音效: 0.6-0.8
- 敌人音效: 0.5-0.7
- 环境音效: 0.3-0.5
- 武器音效: 0.7-0.9

### 4. 错误处理
- 系统提供默认音效fallback机制
- 音频文件缺失时不会导致游戏崩溃
- 控制台会输出详细的调试信息

## 扩展功能

### 1. 添加新的音频分类
1. 在 `AudioType` 枚举中添加新类型
2. 在 `AudioManager` 中添加对应的 `AudioSource`
3. 实现相应的播放和音量控制方法
4. 在 `AudioConfig` 中添加配置

### 2. 动态音频加载
```typescript
// 可以扩展为支持运行时动态加载音频资源
AudioManager.getInstance().loadAudioClip(path).then(clip => {
    // 播放动态加载的音频
});
```

### 3. 音频效果
```typescript
// 可以扩展支持音频效果，如淡入淡出、变调等
AudioManager.getInstance().playWithFadeIn(audioPath, 2.0); // 2秒淡入
```

## 故障排除

### 常见问题

1. **音效不播放**
   - 检查音频文件路径是否正确
   - 确认音频文件格式是否支持
   - 检查音量设置是否为0

2. **音效延迟**
   - 检查音频文件大小
   - 考虑预加载重要音效
   - 优化音频文件格式

3. **音量控制无效**
   - 确认使用了正确的音量控制方法
   - 检查AudioSource组件是否正确初始化

### 调试信息

系统提供详细的控制台日志：
```
[AudioManager] 初始化音频源: UI音效
[EnemyAudios] 播放攻击音效: audio/enemy/goblin/attack
[AudioManager] 设置敌人音效音量: 0.7
```

## 总结

统一音频系统提供了：
- ✅ 分类音频管理
- ✅ 独立音量控制
- ✅ 配置驱动的音效系统
- ✅ 便捷的静态访问接口
- ✅ 完善的错误处理
- ✅ 向后兼容性
- ✅ 可扩展的架构设计

该系统为游戏提供了专业级的音频管理解决方案，支持从简单的音效播放到复杂的音频系统管理的各种需求。