当前位置：首页 > news >正文

杰理可视化SDK开发-音量加/音量减函数讲解

news 2026/5/7 2:11:02

前言

现在为止也开发了许多杰理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或1，1当前提示音在播放、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或1，1当前铃声在播放、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; // 返回获取到的音量值 }