摘要本文基于杰理 AC696N 蓝牙音箱 SDK分步详解自定义提示音完整操作流程包含音频文件存放、配置工具绑定、底层代码修改与播放调用每一步搭配文档内对应界面截图步骤细致适合蓝牙音频开发工程师实操参考。一、准备自定义音频文件1. 定位提示音存放文件夹SDK 路径ac696n_soundbox_sdk_v1.7.0_patch01_dev_board_v0.0.2\cpu\br25\tools\soundbox\standard\extra_tones操作说明打开 standard 文件夹找到extra_tones目录原厂开机、蓝牙连接、模式切换音效全部存放于此。自定义音效文件统一放入该文件夹。2. 音频文件规范要求文件命名仅使用英文禁用中文、特殊符号支持 MP3高音质推荐、WTG低音质两种格式将处理好的音频粘贴至extra_tones记住文件名后续代码配置需完全对应。二、配置工具添加绑定提示音1. 打开配置工具并连接设备在 standard 目录启动配置工具串口选择 CH340 对应 COM 口波特率固定 115200点击刷新串口、打开设备建立通信。2. 进入提示音配置页面添加音效顶部选项卡切换至【提示音配置】点击底部【添加提示音】选中extra_tones内自定义音频工具自动填充文件路径支持单条添加、批量添加选中条目可点击播放试听音效全部配置完成后点击界面保存工具端配置完成。三、SDK 底层代码修改核心步骤步骤 1tone_player.h 新增枚举与资源路径文件路径soundbox/include/tone_player.h在 enum 音效枚举末尾新增自定义音效 ID例IDEX_TONE_WATER,下方宏定义区域新增音频路径宏文件名与音频文件保持一致#define TONE_WATER TONE_RES_ROOT_PATHtone/water.*步骤 2tone_table.c 绑定 ID 与音频资源文件路径soundbox/common/tone_table.c找到tone_table[]映射数组仿照原有格式新增一行映射关系关联枚举 ID 与音频文件[IDEX_TONE_WATER] TONE_RES_ROOT_PATHtone/water.*,步骤 3业务代码调用播放接口代码修改编译完成后在 bt.c、app_main.c 等业务文件中调用播放函数即可触发自定义提示音tone_play(tone_table[IDEX_TONE_WATER], 1);第二个参数 1 代表单次播放可按需调整播放逻辑。总结自定义提示音分三大阶段音频素材放入指定目录、配置工具可视化绑定音效、SDK 头文件与映射表代码配置最后调用播放函数即可使用。全程沿用原厂代码格式仿写上手简单适配 AC696N 蓝牙音箱项目开发。