# 需求：音效映射

> 日期：2026-10-16（对齐五行数字战斗）  
> 资源目录：`assets/bundles/audio/`  
> 播放入口：`BattleAudio`、`gg.audio.playEffect` / `playMusic`

老项目 `sfx/battle`、`sfx/wave` 已删除。无对应新资源的旧播放点不再播。  
**当前局内**见 [需求-五行合成.md](./需求-五行合成.md)：同级数字合成 + 单格上阵；普攻/技能按 **Hero.herotype / Weapon.type** 复用现有 `sfx/weapon` 资源。

## 1. BGM

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

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

| 资源 | 时机 |
|------|------|
| 点击按钮 | `ClickButton`（`gg.audio.playClick`）；三选一/商店翻牌 |
| 体力消耗 | 首页开战扣体力飞行 |
| 匹配完成 | 匹配页切到「站」 |
| 可刷新通知 | 召唤按钮首次变为可刷新 |
| 合成 | 同级数字升级（`BagMerged` / `MapUpgraded` → `playUpgrade`） |
| 怪物受击 | 本机攻击命中 |
| 抽奖转盘 | 每日商店转盘每转一格 |
| 格子放置 | 字落入格子 |
| 武器拖动 | 局内拖字开始 |
| 游戏失败 | 失败结算（`BattleAudio.playFail`） |
| 游戏胜利 | 胜利结算（`BattleAudio.playVictory`） |
| 砚台出字 | 背包刷新每冒出一个字 |
| 结算金币效果 | 胜负领取金币飞行；局内波次结算金币飞行 |
| BOSS出场 | Boss 出场弹窗 |
| 危险警报 | 怪物危机提示每轮动画 |

### 2.1 现有资源、当前无播放点（勿接已删玩法）

| 资源 | 说明 |
|------|------|
| 开场号角 | 开场表演怪已删 |
| 铲子铲地 | 开挖/铲子玩法已删 |
| `sfx/voice/*合成` | 多格神将组合已废弃 |

## 3. 武器（`sfx/weapon/`）— 五行复用

播放：`BattleAudio.playWeaponAttack` / `playWeaponSkill`（仅本机 `Team.ownerId`）。

- 近战等：`SkillController` PresentationCue 时播一次
- **弹道 atk_type 12/13/17**（含水弹连发）：在 `SkillVisualChannel` **真正出手**时播；连发每发一次

### 3.1 普攻（`Hero.herotype`）

| herotype | 资源 |
|----------|------|
| 1 金 | 剑攻击 |
| 2 木 | 棍攻击 |
| 3 水 | 法杖攻击 |
| 4 火 | 箭攻击 |
| 5 土 | 枪攻击 |

### 3.2 英雄主动（`Hero.herotype` → 现有技能资源）

| herotype | 代表技能 | 资源 |
|----------|----------|------|
| 1 金 | 剑阵 | 孙悟空技能 |
| 2 木 | 飞棍 | 悟净技能 |
| 3 水 | 暴风雪 | 阎王技能 |
| 4 火 | 箭雨 | 杨戬技能音效 |
| 5 土 | 冲锋 | 李靖技能 |

### 3.3 宝石武器技能（`Weapon.type`：2金…6土 → element 1…5）

| element | 资源 |
|---------|------|
| 1 金 | 金箍棒技能 |
| 2 木 | 悟净技能 |
| 3 水 | 阎王技能 |
| 4 火 | 杨戬技能音效 |
| 5 土 | 玲珑宝塔技能 |

### 3.4 局内掉落

| 资源 | 时机 |
|------|------|
| 碎片掉落 | 击杀后宝石飞出时 |