# 音频变声器 使用帮助
## 工具简介
本工具为**专业声卡级Web实时变声器**，基于原生`Web Audio API + AudioWorklet`音频底层引擎开发，集成多段EQ音色塑形、共振峰偏移算法、环形延迟特效、**卷积IR专业混响**四大音频处理模块，内置10套成熟人声预设，支持麦克风实时录音、本地音频导入、边调边实时试听，最终无损导出**16bit立体声WAV**音频；广泛用于配音变声、直播实时变音、短视频人声改编、趣味音效制作等场景。

---

## 一、核心功能
- 📡 **双轨道波形可视化**：输入/输出双通道波形实时渲染，直观查看音效变化
- 🎭 **10套一键人声预制**：原声、女神音、男神音、萝莉正太、机械音、磁性大叔、幽灵音、复古电台、花栗鼠、恶魔低音
- 🎛️ **六大精细化人声参数**：基频升降调、低频腔体增益、中频明亮度、高频气声、共振峰位移、输出总音量
- 🏛️ **专业卷积混响系统**：6种行业场景IR预设（Vocal人声/Studio录音室/Plate板式/Hall大厅/Church教堂/Drum鼓房），6项混响自定义参数
- 🎙️ 两种音频载入方式：麦克风在线实时录音、本地音频文件上传（MP3/WAV/OGG/M4A）
- ▶️ 实时播放试听，参数修改即时生效，无需二次渲染
- 💾 后端离线算法重采样，无损导出立体声WAV成品文件

---

## 二、详细操作步骤
### 步骤1：进入工具页面
打开【音频变声器】页面，页面分为**左侧输入&预设区**、**右侧专业参数控制面板**两大分区，上下分区布局自适应手机/电脑。

### 步骤2：导入音频（二选一）
| 导入方式 | 操作说明 |
| ---- | ---- |
| 麦克风录音 | 点击【🎙️ 开始录音】，浏览器授权麦克风权限，讲话录制；录制完毕点击【⏹️停止录音】，音频自动载入 |
| 本地文件 | 点击【📁导入音频】，弹窗选取本地音频文件，支持MP3/WAV/M4A/OGG格式 |

> ✅ 提示：音频载入成功后，状态栏提示文字变更，**播放、导出按钮自动解除禁用**。

### 步骤3：快速套用预制音色（新手首选）
在【✨预制效果】下拉框内，点击选择对应人声模板：
- 👩女神音/👨男神音/👶萝莉正太/🤖机械音/🧔磁性大叔
- 👻幽灵音/📻复古电台/🐿️花栗鼠/😈恶魔低音
选择后**全部参数滑块自动同步数值**，可直接播放试听。

### 步骤4：手动精细化调节人声参数（进阶自定义）
右侧【专业参数调节】六大滑块可自由拖拽修改，每项参数作用如下：
1. **基频(Pitch)：-12 ~ +12st**
    半音升降调，正值升调（萝莉/尖细），负值降调（大叔/低沉）
2. **低频共振(Body)：-10 ~ +10dB**
    控制人声胸腔厚度，男声加大增益，女声小幅降低
3. **中频亮度(Presence)：-10 ~ +10dB**
    提升=口齿清晰透亮，衰减=声音浑厚发闷
4. **高频气声(Air)：-12 ~ +12dB**
    增加空气齿音、气息感，适合女神/少女声；减少用于厚重低音
5. **音色偏移(Formant)：-5 ~ +5**
    **核心变声参数**，改变人声共振峰，正数偏少女、负数偏大叔
6. **输出音量：-20 ~ +6dB**
    统一成品音量大小，避免破音爆麦

### 步骤5：开启&调试专业混响（可选）
1. 打开【专业混响】右侧开关，混响控制面板展开；
2. 快捷选择顶部6种混响预设按钮，一键填充参数；
3. 手动调整混响六项参数：
    - `Pre-Delay预延迟：0~100ms`：原声和反射间隔
    - `Decay衰减：10~100`：混响尾音长短
    - `Size空间：5~100`：模拟房间体积大小
    - `Damp阻尼：0~100`：高频衰减程度
    - `Width宽度：0~100`：立体声声场宽窄
    - `Mix干湿比：0~100%`：原声与混响音效占比

### 步骤6：实时试听音效
点击【▶️播放】，双通道波形开始动态绘制，调整任意参数**实时生效**；需要暂停点击【⏹️停止】。

### 步骤7：导出成品音频
人声、混响全部调试满意后，点击【💾导出WAV】，前端自动离线重采样运算，处理完成浏览器自动下载无损WAV音频文件。

---

## 三、参数参考推荐表
| 人声类型 | 基频st | 低频dB | 中频dB | 高频dB | 共振峰 | 干湿混响占比 |
| ---- | ---- | ---- | ---- | ---- | ---- | ---- |
| 女神少女 | +4~+5 | -3~-5 | +3~+5 | +5~+7 | +1.2~+1.8 | 25%~35% |
| 磁性大叔 | -6~-8 | +6~+9 | -3~-5 | -4~-6 | -1.5~-2.2 | 20%~30% |
| 萝莉正太 | +7~+10 | -6~-8 | +5~+7 | +7~+10 | +2~+3 | 30%~40% |
| 低沉恶魔 | -9~-11 | +8~+10 | -5~-7 | -8~-10 | -2.5~-3.5 | 35%~50% |
| 电台旁白 | -1~-2 | -1~-3 | +2~+4 | -7~-9 | 0 | 15%~25% |

> 💡混响小知识：
> ① 人声配音优先选用`Vocal`人声混响；
> ② 空旷氛围感使用`Hall/Church`大厅、教堂预设，衰减>60、空间>70。

### 补充使用注意
1. **麦克风权限**：首次录音必须允许浏览器麦克风权限，拒绝则无法录制；
2. **音频格式**：仅支持MP3/WAV/M4A/OGG，FLAC、APE、加密音频无法解析；
3. **导出规格**：统一输出**44100Hz 16bit 立体声WAV**无损格式；
4. **浏览器适配**：推荐`Chrome / Edge`，不兼容IE、老旧内核浏览器。

---

## 四、常见错误与解决方案
### 错误1：点击录音无反应/无法调取麦克风
- 原因：浏览器禁用麦克风权限、网页非HTTPS协议、设备无可用麦克风
- 解决：浏览器设置开启麦克风权限，更换Chrome浏览器

### 错误2：导入音频成功，播放没有任何声音
- 原因：浏览器音频静音策略、音频文件损坏
- 解决：手动取消浏览器标签静音，更换正常音频文件重试

### 错误3：开启混响几乎听不到回响效果
- 原因：混响【Mix干湿比】数值过低、衰减时长过小
- 解决：把干湿混合比拉至30%以上，提升Decay衰减、Size空间参数

### 错误4：导出WAV失败、提示渲染异常
- 原因：音频时长过长、浏览器性能不足、内核不支持AudioWorklet
- 解决：裁剪音频缩短时长，切换Chrome浏览器重新导出

### 错误5：人声刺耳尖锐 / 声音沉闷发糊
- 刺耳：**降低高频增益、加大高频阻尼数值**
- 沉闷：**提升中频参数、减小低频增益、降低阻尼**