1. MP3 文件获取

• 首先制作提示音
  • 推荐网站：暂无，可自行在网络寻求 MP3 音频资源
• 格式要求：
  • 采样率：16KHz
  • 声道：单声道
• 提示音列表，该文件的路径：aipi-palchat_v2/doubao/lib/axk_app/tone.h

提示音的名称不能改变，否则会影响后续步骤的进行！

序号	提示音数组名称	示例内容
1	tone_wozai	我在
2	tone_weipeiwang	我是你的人工智能语音助手。请对我说：你好小安。开始配网
3	tone_kaishipeiwang	进入配网模式，请使用安信可小程序或 App 进行配网
4	tone_peiwangshibai	配网超时，请重试
5	tone_peiwangchenggong	配网成功
6	tone_lianwangchenggong	联网成功
7	tone_wangluoduankai	网络异常，重新连接
8	tone_lianwangzhong	联网中
9	tone_lianwangshibai	联网失败
10	tone_yipeiwang	我是你的人工智能语音助手。请对我说：你好小安。唤醒我
11	tone_tuixia	退下了

2. 音频转换

为了大家方便使用直接生成音频数组，我们提供了一个将 MP3 文件夹批量转换为 Opus 格式（16kHz 采样率、单声道）的 C 语言头文件的 Python 脚本。这个脚本会使用 ffmpeg 进行格式转换，运行之前请安装好脚本执行的依赖工具。

▫️脚本环境安装

- 安装python3，如已有请跳过，使用python --version查看是否已安装
```shell
sudo apt-get install python3
```
- 安装ffmpeg以及opus编码器
```shell
sudo apt-get install ffmpeg libopus0 libopus-dev
```

▫️脚本使用

- 进入到 MP3_Conversion 文件夹
```shell
cd MP3_Conversion
```
- 运行脚本
```shell
./mp3_to_opus.py  东北表姐/ -o 东北表姐/tone.h
```

该命令是运行batch_mp3_to_opus_header_simplified.py，第一个参数为音频文件夹，第二个为需要输出的文件路径和文件名称

(点击查看) 成功示例

(点击查看) 该脚本会以预定的格式输出.h文件

- 替换原文件
```shell
cp 东北表姐/tone.h aipi-palchat_v2/doubao/lib/axk_app/tone.h
```

3. 编译测试

▫️进入 boubao 目录

cd ../doubao

▫️编译

make

▫️烧录

make flash COMX=/dev/ttyACM0

COMX为串口名称，请根据实际情况修改

4. 问题及解决方法

(点击查看) 安装opuslib和numpy库时出错

环境问题导致的安装出错，可通过以下步骤解决。

• 安装 python 虚拟环境工具

  sudo apt install python3-venv

• 创建虚拟环境（例如在项目目录）

  python3 -m venv myenv

• 激活虚拟环境

  source myenv/bin/activate

• 重新安装依赖库

  pip3 install ffmpeg-python pydub numpy opuslib