今天,继续讲解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调试,敬请期待!