杰理 AC696N 开发分享 —— 自定义更改提示音

摘要本文基于杰理 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目录，原厂开机、蓝牙连接、模式切换音效全部存放于此。自定义音效文件统一放入该文件夹。
https://ima-notebook-prod.image.myqcloud.com/2/d3kbCeYD2DyOJFf58fofxe/file_manager/019f3a60f874713eba9cf6b40a1b6ec2.webp?q-sign-algorithm=sha1&q-ak=AKID9IDtLZZKqGRO7hVFnMn0zjXTXovoTtAN&q-sign-time=1783390861%3B1783434061&q-key-time=1783390861%3B1783434061&q-header-list=&q-url-param-list=&q-signature=bf46aa6b462ba79d05092da4bcf81503cdae93a6
2. 音频文件规范要求
[*]文件命名仅使用英文，禁用中文、特殊符号；
[*]支持 MP3（高音质推荐）、WTG（低音质）两种格式；
[*]将处理好的音频粘贴至extra_tones，记住文件名，后续代码配置需完全对应。
二、配置工具添加绑定提示音1. 打开配置工具并连接设备在 standard 目录启动配置工具，串口选择 CH340 对应 COM 口，波特率固定 115200，点击刷新串口、打开设备建立通信。
https://ima-notebook-prod.image.myqcloud.com/2/d3kbCeYD2DyOJFf58fofxe/file_manager/019f3a62004a7a0fa3aafa89738f58a4.webp?q-sign-algorithm=sha1&q-ak=AKID9IDtLZZKqGRO7hVFnMn0zjXTXovoTtAN&q-sign-time=1783390929%3B1783434129&q-key-time=1783390929%3B1783434129&q-header-list=&q-url-param-list=&q-signature=75d341487c2d300a559466f943477fd2ae12f491
2. 进入提示音配置页面添加音效
[*]顶部选项卡切换至【提示音配置】；
[*]点击底部【添加提示音】，选中extra_tones内自定义音频，工具自动填充文件路径；
[*]支持单条添加、批量添加，选中条目可点击播放试听音效；
[*]全部配置完成后点击界面保存，工具端配置完成。
https://ima-notebook-prod.image.myqcloud.com/2/d3kbCeYD2DyOJFf58fofxe/file_manager/019f3a623e8079ebbd39b56a6184faf8.webp?q-sign-algorithm=sha1&q-ak=AKID9IDtLZZKqGRO7hVFnMn0zjXTXovoTtAN&q-sign-time=1783390944%3B1783434144&q-key-time=1783390944%3B1783434144&q-header-list=&q-url-param-list=&q-signature=922ec7338b2523478c35e7e22bf6fb8c5214b104三、SDK 底层代码修改（核心步骤）步骤 1：tone_player.h 新增枚举与资源路径文件路径：soundbox/include/tone_player.h

[*]在 enum 音效枚举末尾新增自定义音效 ID，例：IDEX_TONE_WATER,；
[*]下方宏定义区域新增音频路径宏，文件名与音频文件保持一致：#define TONE_WATER TONE_RES_ROOT_PATH"tone/water.*"
https://ima-notebook-prod.image.myqcloud.com/2/d3kbCeYD2DyOJFf58fofxe/file_manager/019f3a64025e77efae186362a5b54b14.webp?q-sign-algorithm=sha1&q-ak=AKID9IDtLZZKqGRO7hVFnMn0zjXTXovoTtAN&q-sign-time=1783391060%3B1783434260&q-key-time=1783391060%3B1783434260&q-header-list=&q-url-param-list=&q-signature=e163070f974c4adfe1425ce992e7875562c882db步骤 2：tone_table.c 绑定 ID 与音频资源文件路径：soundbox/common/tone_table.c找到tone_table[]映射数组，仿照原有格式新增一行映射关系，关联枚举 ID 与音频文件： = TONE_RES_ROOT_PATH"tone/water.*",
步骤 3：业务代码调用播放接口代码修改编译完成后，在 bt.c、app_main.c 等业务文件中调用播放函数，即可触发自定义提示音：tone_play(tone_table, 1);第二个参数 1 代表单次播放，可按需调整播放逻辑。
总结自定义提示音分三大阶段：音频素材放入指定目录、配置工具可视化绑定音效、SDK 头文件与映射表代码配置，最后调用播放函数即可使用。全程沿用原厂代码格式仿写，上手简单，适配 AC696N 蓝牙音箱项目开发。