前言现在为止也开发了许多杰理TWS蓝牙耳机、音响项目 SDK的案子在调试案子时不断的向前辈们学习到了很多关于蓝牙音响、蓝牙TWS耳机专业的知识。想在这里做一个学习汇总方便各位同行和对杰理芯片可视化SDK感兴趣的小伙伴们学习本章详细讲解杰理可视化SDK-音量加/音量减函数音量加函数和音量减函数是我们开发时常用的函数几乎是必备开发使用函数之一。本章就详细分析讲解void bt_volume_up(u8 inc)音量加函数void bt_volume_up(u8 dec) { u8 test_box_vol_up 0x41; // 测试盒指令音量加 s8 cur_vol 0; //当前音量 u8 call_status bt_get_call_status(); // 获取当前通话状态 u8 cur_state; // 当前音频状态 (通话/音乐) s16 max_volume; // 当前状态下的最大音量 u8 data[6]; // 存储蓝牙设备地址 a2dp_player_get_btaddr(data); // 获取当前连接的A2DP设备地址 // 场景1: 如果正在播放提示音或铃声 if ((tone_player_runing() || ring_player_runing())) { if (bt_get_call_status() BT_CALL_INCOMING) { // 仅在来电状态下才允许直接调节音量 volume_up_down_direct(1); // 直接调节音量可能绕过某些逻辑 } return; // 其他情况如普通提示音则不响应音量键 } // 场景2: 区分通话状态和音乐状态以确定当前音频上下文和最大音量 /*打电话出去彩铃要可以调音量大小*/ if ((call_status BT_CALL_ACTIVE) || (call_status BT_CALL_OUTGOING)) { cur_state APP_AUDIO_STATE_CALL; // 设置为通话状态 max_volume app_audio_volume_max_query(AppVol_BT_CALL);// 查询通话最大音量 } else { cur_state APP_AUDIO_STATE_MUSIC; // 设置为音乐状态 max_volume app_audio_volume_max_query(AppVol_BT_MUSIC);// 查询音乐最大音量 } cur_vol app_audio_get_volume(cur_state); // 获取当前音量 if (bt_get_remote_test_flag()) { bt_cmd_prepare(USER_CTRL_TEST_KEY, 1, test_box_vol_up); //音量加 } // 场景3: 处理音量已达最大值的情况 /* if (cur_vol app_audio_get_max_volume()) { */ if (cur_vol max_volume) { audio_event_to_user(AUDIO_EVENT_VOL_MAX); //触发vol max事件// 触发“音量最大”事件用于UI提示 if (bt_get_call_status() ! BT_CALL_HANGUP) { // 如果仍在通话中需要同步手机端音量防止显示不同步 /*本地音量最大如果手机音量还没最大继续加以防显示不同步*/ if (g_bt_hdl.phone_vol 15) { // 假设手机最大音量等级为15 if (bt_get_curr_channel_state() HID_CH) { // 如果是HID通道 bt_cmd_prepare(USER_CTRL_HID_VOL_UP, 0, NULL); } else { // 否则是HFP通道 bt_cmd_prepare(USER_CTRL_HFP_CALL_VOLUME_UP, 0, NULL); } } return; // 本地音量已达最大不再增加 } #if TCFG_BT_VOL_SYNC_ENABLE // 如果启用了蓝牙音量同步发送同步增加的指令给手机 opid_play_vol_sync_fun(app_var.music_volume, 1); // 更新同步音量变量 bt_cmd_prepare_for_addr(data, USER_CTRL_CMD_SYNC_VOL_INC, 0, NULL); #endif/*TCFG_BT_VOL_SYNC_ENABLE*/ return; } // 场景4: 正常增加音量 #if TCFG_BT_VOL_SYNC_ENABLE opid_play_vol_sync_fun(app_var.music_volume, 1); // 更新同步音量变量 app_audio_set_volume(APP_AUDIO_STATE_MUSIC, app_var.music_volume, 1); // 设置新音量 #else app_audio_volume_up(inc); // 不启用同步时直接调用底层函数增加音量 #endif/*TCFG_BT_VOL_SYNC_ENABLE*/ printf(vol: %d, app_audio_get_volume(APP_AUDIO_CURRENT_STATE)); // 场景5: 音量增加后同步通知手机端 if (bt_get_call_status() ! BT_CALL_HANGUP) { // 如果在通话中 if (bt_get_curr_channel_state() HID_CH) { bt_cmd_prepare(USER_CTRL_HID_VOL_UP, 0, NULL); } else { bt_cmd_prepare(USER_CTRL_HFP_CALL_VOLUME_UP, 0, NULL); } } else { // 如果在音乐播放状态 #if TCFG_BT_VOL_SYNC_ENABLE bt_cmd_prepare_for_addr(data, USER_CTRL_CMD_SYNC_VOL_INC, 0, NULL); //使用HID调音量 #endif } }void bt_volume_down(u8 inc)音量减函数void bt_volume_down(u8 dec) { u8 test_box_vol_down 0x42; // 测试盒指令音量减 u8 call_status bt_get_call_status(); // 获取当前通话状态 u8 cur_state; // 当前音频状态 (通话/音乐) u8 data[6]; // 存储蓝牙设备地址 a2dp_player_get_btaddr(data); // 获取当前连接的A2DP设备地址 // 场景1: 如果正在播放提示音或铃声 if ((tone_player_runing() || ring_player_runing())) { if (bt_get_call_status() BT_CALL_INCOMING) { // 仅在来电状态下才允许直接调节音量 volume_up_down_direct(-1); // 直接调节音量可能绕过某些逻辑 } return; // 其他情况如普通提示音则不响应音量键 } if (bt_get_remote_test_flag()) { // 远程测试模式 bt_cmd_prepare(USER_CTRL_TEST_KEY, 1, test_box_vol_down); //音量减 } // 场景2: 区分通话状态和音乐状态以确定当前音频上下文和最大音量 /* 打电话出去彩铃要可以调音量大小 */ if ((call_status BT_CALL_ACTIVE) || (call_status BT_CALL_OUTGOING)) { cur_state APP_AUDIO_STATE_CALL; // 设置为通话状态 } else { cur_state APP_AUDIO_STATE_MUSIC; // 设置为音乐状态 } // 场景3: 处理音量已达最小值的情况 /* if (app_audio_get_volume(APP_AUDIO_CURRENT_STATE) 0) { */ if (app_audio_get_volume(cur_state) 0) { audio_event_to_user(AUDIO_EVENT_VOL_MIN); //触发vol mix事件 if (bt_get_call_status() ! BT_CALL_HANGUP) { /* *本地音量最小如果手机音量还没最小继续减 *注意有些手机通话最小音量是1(GREE G0245D) */ if (g_bt_hdl.phone_vol 1) { if (bt_get_curr_channel_state() HID_CH) { // 如果是HID通道 bt_cmd_prepare(USER_CTRL_HID_VOL_DOWN, 0, NULL); } else { // 否则是HFP通道 bt_cmd_prepare(USER_CTRL_HFP_CALL_VOLUME_DOWN, 0, NULL); } } return; // 本地音量已达最小不再减小 } // 如果启用了蓝牙音量同步发送同步增加的指令给手机 #if TCFG_BT_VOL_SYNC_ENABLE opid_play_vol_sync_fun(app_var.music_volume, 0); // 更新同步音量变量 bt_cmd_prepare_for_addr(data, USER_CTRL_CMD_SYNC_VOL_DEC, 0, NULL); #endif return; } // 场景4: 正常减少音量 #if TCFG_BT_VOL_SYNC_ENABLE opid_play_vol_sync_fun(app_var.music_volume, 0); // 更新同步音量变量 app_audio_set_volume(APP_AUDIO_STATE_MUSIC, app_var.music_volume, 1);// 设置新音量 #else app_audio_volume_down(dec); // 不启用同步时直接调用底层函数 #endif/*TCFG_BT_VOL_SYNC_ENABLE*/ printf(vol-: %d, app_audio_get_volume(APP_AUDIO_CURRENT_STATE)); // 场景5: 音量减小后同步通知手机端 if (bt_get_call_status() ! BT_CALL_HANGUP) { // 通话中 if (bt_get_curr_channel_state() HID_CH) { bt_cmd_prepare(USER_CTRL_HID_VOL_DOWN, 0, NULL); } else { bt_cmd_prepare(USER_CTRL_HFP_CALL_VOLUME_DOWN, 0, NULL); } } else { // 音乐中 #if TCFG_BT_VOL_SYNC_ENABLE /* opid_play_vol_sync_fun(app_var.music_volume, 0); */ if (app_audio_get_volume(APP_AUDIO_CURRENT_STATE) 0) { app_audio_volume_down(0); } bt_cmd_prepare_for_addr(data, USER_CTRL_CMD_SYNC_VOL_DEC, 0, NULL); #endif } }注意如是TWS蓝牙项目使用上方两个函数需要与bt_tws_sync_volume()一起使用用于在TWS耳机的主设备上获取当前音量设置并将这些设置同步到从设备。void bt_tws_sync_volume() { u8 data[2]; // 定义一个2字节的数组用于存储音量数据 // 获取音乐播放状态的音量并存储在data[0] data[0] app_audio_get_volume(APP_AUDIO_STATE_MUSIC); // 获取通话状态的音量并存储在data[1] data[1] app_audio_get_volume(APP_AUDIO_STATE_CALL); // 通过TWS API将音量数据发送到从设备 // 参数数据指针、数据长度、功能ID(音量同步) tws_api_send_data_to_slave(data, 2, TWS_FUNC_ID_VOL_SYNC); }如图所示代码学习int a2dp_player_get_btaddr(u8 *btaddr) 获取当前连接的A2DP设备地址函数原型int a2dp_player_get_btaddr(u8 *btaddr) { if (g_a2dp_player) { memcpy(btaddr, g_a2dp_player-bt_addr, 6); return 1; } return 0; }int tone_player_runing(); 返回是否有提示音在播放函数原型返回值可以观察到无非就是0或11当前提示音在播放、0未播放int tone_player_runing() { local_irq_disable(); int ret list_empty(g_head) ? 0 : 1; local_irq_enable(); return ret; }int ring_player_runing() 返回是否有铃声在播放函数原型返回值可以观察到无非就是0或11当前铃声在播放、0未播放int ring_player_runing() { return g_ring_player ? 1 : 0; }u8 bt_get_call_status(); 获取当前蓝牙电话状态u8 bt_get_call_status(); 与BT_CALL_IND_STA 枚举的值判断用于获取当前蓝牙电话的状态typedef enum { BT_CALL_BATTERY_CHG 0, //电池电量改变 BT_CALL_SIGNAL_CHG, //网络信号改变 BT_CALL_INCOMING, //电话打入 BT_CALL_OUTGOING, //电话打出 BT_CALL_ACTIVE, //接通电话 BT_CALL_HANGUP, //电话挂断 BT_CALL_ALERT, //远端reach BT_SIRI_STATE, //SIRI状态 BT_CALL_VOL_CHANGED, } BT_CALL_IND_STA;void volume_up_down_direct(s16 value); 直接调节音量函数原型看不到哟小伙伴们在杰理底层不让看哈!s16 app_audio_volume_max_query(audio_vol_index_t index)获取目标最大音量值形参填入音量名称index//音量名称index typedef enum { AppVol_BT_MUSIC 0, AppVol_BT_CALL, AppVol_LINEIN, AppVol_MUSIC, AppVol_FM, AppVol_SPDIF, AppVol_USB, SysVol_TONE, SysVol_KEY_TONE, Vol_NULL, } audio_vol_index_t;函数原型s16 app_audio_volume_max_query(audio_vol_index_t index) { if (index Vol_NULL) { return volume_ioc_get_max_level(audio_vol_str[index]); } else { return volume_ioc_get_max_level(audio_vol_str[Vol_NULL]); } }s16 app_audio_get_volume(u8 state) 获取指定状态对应音量值形参填入#define APP_AUDIO_STATE_IDLE 0 // 空闲状态 #define APP_AUDIO_STATE_MUSIC 1 // 音乐播放状态 #define APP_AUDIO_STATE_CALL 2 // 通话状态 #define APP_AUDIO_STATE_WTONE 3 // 提示音状态 #define APP_AUDIO_STATE_KTONE 4 // 按键音状态 #define APP_AUDIO_STATE_RING 5 // 铃声状态 #define APP_AUDIO_CURRENT_STATE 6 // 当前状态函数原型s16 app_audio_get_volume(u8 state) { s16 volume 0; switch (state) { case APP_AUDIO_STATE_IDLE: // 空闲状态 case APP_AUDIO_STATE_MUSIC: // 音乐播放状态 volume app_var.music_volume; // 使用音乐音量 break; case APP_AUDIO_STATE_CALL: // 通话状态 volume app_var.call_volume; // 使用通话音量 break; case APP_AUDIO_STATE_WTONE: // 提示音状态 volume app_var.wtone_volume; // 使用提示音音量 if (!volume) { // 如果提示音音量为0 volume app_var.music_volume; // 使用音乐音量作为默认值 } break; case APP_AUDIO_STATE_KTONE: // 按键音状态 volume app_var.ktone_volume; // 使用按键音音量 if (!volume) { // 如果按键音音量为0 volume app_var.music_volume; // 使用音乐音量作为默认值 } break; case APP_AUDIO_STATE_RING: // 铃声状态 volume app_var.ring_volume; // 使用铃声音量 if (!volume) { // 如果铃声音量为0 volume app_var.music_volume; // 使用音乐音量作为默认值 } break; case APP_AUDIO_CURRENT_STATE: // 当前状态 volume app_audio_get_volume(__this-state); // 递归获取当前状态音量 break; default: // 默认情况 break; // 不做处理返回0 } return volume; // 返回获取到的音量值 }bool bt_get_remote_test_flag(); 当前连接的设备是不是jl测试盒函数原型返回值为1则为JL测试盒返回值为0则不是u32 bt_cmd_prepare(USER_CMD_TYPE cmd, u16 param_len, u8 *param) ;单个连接的时候不想管地址的命令接口函数原型cmd 用户可以使用USER_CMD_TYPE的枚举值param_len 传参数需要的值或者data包的长度param 传的是要发数据的包指针u32 bt_cmd_prepare_for_addr(u8 *addr, USER_CMD_TYPE cmd, u16 param_len, u8 *param); 发送命令的接口函数原型addr指定就按指定的查找NULL就默认正在使用那个cmd 用户可以使用USER_CMD_TYPE的枚举值param_len 传参数需要的值或者data包的长度param 传的是要发数据的包指针制作不易喜欢的小伙伴给个小赞赞喜欢我的小伙伴点个关注有不懂的地方和需要的资源随时问我哟