BES(恒玄)提示音解析

今天，继续讲解BES平台 UI 最后模块--- 提示音.

提示音这一块比较繁琐，也很容易出问题，我们就 提示音实现机制，问题点 做个全面的讲解。

BES 提示音分为两种 触发模式 ，第一种是打断的 ，第二种是mix类型的 。

首先，说下 BES单机模式下 提示音执行流程和机制。

一、单机模式下的提示音流程

BES 提示音的 总入口 是 ：app_voice_report(APP_STATUS_INDICATION_T status, uint8_t device_id)；

其中 ：APP_STATUS_INDICATION_T 枚举类型数据 提示音序号，用来索引提示音ID  ，device_id  表示设备号，一般是0.

通过“void trigger_media_play(AUD_ID_ENUM id, uint8_t devicSe_id, uint16_t aud_pram)”向主线程发出提示音任务请求.

然后跳转到 “app_audio_manager_handle_process”执行.

最后所有的提示音都会跑到“int app_play_audio_onoff(bool onoff, APP_AUDIO_STATUS* status)”里面，在这个函数里面可以设置提示音声道 /采样率 等属性。

最后在函数 “void media_Play_init_audio(uint16_t aud_id)”获取 SBC 数据（media_runtime_audio_prompt_update）.

这个修改项一般 相对简单，对应ID 修改SBC原文件就好，例如：

在 res_audio_data.h 里面 找到对用的 提示音源文件并修改。

提示音SBC源文件在工程文件 目录下/config/_default_cfg_src_/res/en 里面

TWS 模式下的 提示音播放 就是在 提示音消息发出之前 增加 一些条件判断和同步等待。

二 、Merge 提示音

上面说的 都是 打断的提示音（会中断当前的音乐/通话），现在说下 mixer的提示音。

和SBC数据不一样，Merge提示音需要PCM（3：1） 格式的数据，所以需要占用更多的存储空间，源文件一般保存在/config/_default_cfg_src_/ring 里面

由于打断类型的提示音需要重复开关codec ，在通话的时候容易产生电流声进而传输带远端，所有在BES2300系列的软件里面需要用到merge提示音.

在WT230U 2300IU  2300IU1 2300ZP 系列早期的SDK 都需要关闭混合提示音的宏。

export MIX_AUDIO_PROMPT_WITH_A2DP_MEDIA_ENABLED ?= 0
export TWS_PROMPT_SYNC ?= 0

使用接口函数 ：merge_start：int app_ring_merge_start(void)；merge_stop ：int app_ring_merge_stop(void)；

需要注意的是，这个接口都是单边有效，如果在TWS模式，需要自己添加提示音同步机制

当然后面出来的 2500系类 和 2300YP 后期SDK 已经解决了打开混合 提示音宏定义 导致的 死机或者卡顿问题，可以在target.mk里面直接打开

export MIX_AUDIO_PROMPT_WITH_A2DP_MEDIA_ENABLED ?= 1 也就不需要用到以上接口了 .

三、提示音常见问题：

1. 播放提示音没有声音

a. 设置声音过小导致：

早期代码在 Tgt_hardware.c里面配置提示音音量大小（第一个）

后面SDK更新后 提示音大小设置到了 app_media_player.cpp 里面设置

b.无法找到相关SBC数据文件，

一般我会在media_runtime_audio_prompt_update 函数最后添加打印“TRACE(1,"media_runtime_audio_prompt_update,current id is %d\n",id);”确认是否关联到了对应的SBC文件。

c.其他原因被打断的，根据上述提示音播放流程逐步跟踪。

d.merge提示音无法播放：

在通话或者音乐播放的函数里面确认app_ring_merge_more_data 是否被执行。

2.TWS 提示音播放不同步 或者 副耳无提示音的问题

a. 单边播放问题 ：检查当前提示音是否为 单边播放或只设置了单声道

b. 由于延迟偏差不同步导致的副耳无法播放：修改提示音TWS播放等待延迟.在app_ibrt_voice_report_trigger_init 函数里面修改 延迟.(具体数值以实际调试为准，下面数值仅作参考)

例如 :

if (report_role == VOICE_REPORT_MASTER){app_ibrt_voice_report_info_t voice_report_info;switch(aud_id){ /**Different prompt tone delays adjust for TWS sync by sanke**/case AUD_ID_BT_MIC_MUTE:case AUD_ID_BT_MIC_UNMUTE:case AUD_ID_BT_CONNECTED:tg_tick = curr_ticks + US_TO_BTCLKS(APP_PLAY_CONNECTED_AUDIO_SYNC_DELAY_US);tg_tick_tiemout = APP_PLAY_CONNECTED_AUDIO_SYNC_TRIGGER_TIMEROUT;break;case AUD_ID_BT_PAIRING:tg_tick = curr_ticks + US_TO_BTCLKS(APP_PLAY_AUDIO_SYNC_DELAY_US*2);tg_tick_tiemout = APP_PLAY_AUDIO_SYNC_TRIGGER_TIMEROUT*2;break;default:tg_tick = curr_ticks + US_TO_BTCLKS(APP_PLAY_AUDIO_SYNC_DELAY_US);tg_tick_tiemout=APP_PLAY_AUDIO_SYNC_TRIGGER_TIMEROUT;break;}
}
....///
else if (report_role == VOICE_REPORT_SLAVE){tg_tick = app_ibrt_voice_tg_tick;if (curr_ticks //......
}

修改函数app_ibrt_voice_report_set_trigger_time为如下：

static void app_ibrt_voice_report_set_trigger_time(uint32_t tg_tick,uint32_t tg_tick_timeout)
{if (tg_tick){ibrt_ctrl_t *p_ibrt_ctrl = app_ibrt_if_get_bt_ctrl_ctx();btif_connection_role_t connection_role = app_tws_ibrt_get_local_tws_role();btdrv_syn_trigger_codec_en(0);btdrv_syn_clr_trigger(0);btdrv_enable_playback_triggler(ACL_TRIGGLE_MODE);if (connection_role == BTIF_BCR_MASTER){bt_syn_set_tg_ticks(tg_tick, p_ibrt_ctrl->tws_conhandle, BT_TRIG_MASTER_ROLE,0);}else if (connection_role == BTIF_BCR_SLAVE){bt_syn_set_tg_ticks(tg_tick, p_ibrt_ctrl->tws_conhandle, BT_TRIG_SLAVE_ROLE,0);}btdrv_syn_trigger_codec_en(1);app_ibrt_voice_report_trigger_checker_start(tg_tick_timeout);TRACE_VOICE_RPT_I("[TRIG] set trigger tg_tick:%08x", tg_tick);}else{btdrv_syn_trigger_codec_en(0);btdrv_syn_clr_trigger(0);bt_syn_cancel_tg_ticks(0);app_ibrt_voice_report_trigger_checker_stop();TRACE_VOICE_RPT_I("[TRIG] trigger clear");}
}

3.混合提示音 声音大小：（audio_prompt_sbc.cpp）

在较新SDK里面打开 MIX_AUDIO_PROMPT_WITH_A2DP_MEDIA_ENABLED 后 如果在音乐播放状态容易出现 提示音播放导致声音忽大忽小的问题，请调整以下参数

DEFAULT_COEFF_FOR_MIX_PROMPT_FOR_MUSIC  

4. 固定提示音采样率（需要与SBC源文件采样率匹配）

5. 由于音频中断但merge_prompt还在运行播放导致的死机问题：

在int bt_sco_player(bool on, enum APP_SYSFREQ_FREQ_T freq) 和 int bt_sbc_player(enum PLAYER_OPER_T on, enum APP_SYSFREQ_FREQ_T freq) 处添加：

if(app_ring_merge_isrun()){app_ring_merge_stop();
} /***To slove painc case ，while call or music stop but tone is merge start ！sanke***/

以上大致就是BES提示音 讲解和 常见问题点分析，有不当之处，请指正，谢谢！

后续会更新 IRBT对耳通讯和 EQ/ANC调试，敬请期待！