# 需求：音效映射

> 日期：2026-09-08  
> 资源目录：`assets/bundles/audio/`  
> 播放入口：`BattleAudio`、`gg.audio.playEffect` / `playMusic`

老项目 `sfx/battle`、`sfx/wave` 已删除。无对应新资源的旧播放点不再播，不用其它音效顶替。

## 1. BGM

| 资源 | 时机 |
|------|------|
| `bgm/首页背景音` | 大厅 |
| `bgm/局内背景音` | 进战斗 |

## 2. UI（`sfx/ui/`）

| 资源 | 时机 |
|------|------|
| 点击按钮 | 按钮上的 `ClickButton` 组件（`gg.audio.playClick`） |
| 体力消耗 | 首页开战扣体力飞行 |
| 匹配完成 | 匹配页切到「站」 |
| 可刷新通知 | 召唤按钮首次变为可刷新 |
| 合成 | 同字升级 / 神将组合 |
| 怪物受击 | 本机攻击命中 |
| 抽奖转盘 | 每日商店转盘每转一格 |
| 格子放置 | 字落入格子 |
| 武器拖动 | 局内拖字开始 |
| 游戏失败 | 失败结算打开 |
| 游戏胜利 | 胜利结算打开 |
| 砚台出字 | 背包刷新每冒出一个字 |
| 结算金币效果 | 胜负领取金币飞行 |
| 铲子铲地 | 铲子挖地 |

## 3. 语音（`sfx/voice/`）

合成神将时播对应语音（仅下列有资源）：孙悟空 / 哪吒 / 杨戬 / 王母 / 玉帝 / 李靖。

## 4. 武器（`sfx/weapon/`）

### 4.1 普攻（按 Hero.weapon）

| weapon | 资源 | 代表 |
|--------|------|------|
| 1 | 刀攻击 | 刀、悟能、木吒、玉帝、阎王、李靖 |
| 2 | 枪攻击 | 枪、哪吒、金吒、杨戬 |
| 3 | 棍攻击 | 棍、悟空、悟净 |
| 4 | 箭攻击 | 弓、王母、嫦娥 |

### 4.2 英雄主动

| Hero.id | 资源 |
|---------|------|
| 11 悟空 | 孙悟空技能 |
| 13 悟净 | 悟净技能 |
| 17 杨戬 | 杨戬技能音效 |
| 20 阎王 | 阎王技能 |
| 22 李靖 | 李靖技能 |

### 4.3 专属武器技能

| Skill.id | 资源 |
|----------|------|
| 20501 如意金箍棒 | 金箍棒技能 |
| 20509 玲珑宝塔 | 玲珑宝塔技能 |

### 4.4 局内掉落

| 资源 | 时机 |
|------|------|
| 碎片掉落 | 击杀后武器碎片飞出时 |