杰理 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目录，原厂开机、蓝牙连接、模式切换音效全部存放于此。自定义音效文件统一放入该文件夹。

2. 音频文件规范要求

文件命名仅使用英文，禁用中文、特殊符号；

支持 MP3（高音质推荐）、WTG（低音质）两种格式；

将处理好的音频粘贴至extra_tones，记住文件名，后续代码配置需完全对应。

二、配置工具添加绑定提示音

1. 打开配置工具并连接设备

在 standard 目录启动配置工具，串口选择 CH340 对应 COM 口，波特率固定 115200，点击刷新串口、打开设备建立通信。

2. 进入提示音配置页面添加音效

顶部选项卡切换至【提示音配置】；

点击底部【添加提示音】，选中extra_tones内自定义音频，工具自动填充文件路径；

支持单条添加、批量添加，选中条目可点击播放试听音效；

全部配置完成后点击界面保存，工具端配置完成。

三、SDK 底层代码修改（核心步骤）

步骤 1：tone_player.h 新增枚举与资源路径

文件路径：soundbox/include/tone_player.h

在 enum 音效枚举末尾新增自定义音效 ID，例：IDEX_TONE_WATER,；

下方宏定义区域新增音频路径宏，文件名与音频文件保持一致：#define TONE_WATER TONE_RES_ROOT_PATH"tone/water.*"

步骤 2：tone_table.c 绑定 ID 与音频资源

文件路径：soundbox/common/tone_table.c找到tone_table[]映射数组，仿照原有格式新增一行映射关系，关联枚举 ID 与音频文件：[IDEX_TONE_WATER] = TONE_RES_ROOT_PATH"tone/water.*",

步骤 3：业务代码调用播放接口

代码修改编译完成后，在 bt.c、app_main.c 等业务文件中调用播放函数，即可触发自定义提示音：tone_play(tone_table[IDEX_TONE_WATER], 1);第二个参数 1 代表单次播放，可按需调整播放逻辑。

总结

自定义提示音分三大阶段：音频素材放入指定目录、配置工具可视化绑定音效、SDK 头文件与映射表代码配置，最后调用播放函数即可使用。全程沿用原厂代码格式仿写，上手简单，适配 AC696N 蓝牙音箱项目开发。