经典蓝牙音量同步机制

经典蓝牙的媒体音量与通话音量是两套独立机制：

A2DP 和 SCO/eSCO 负责承载音频；

音量控制分别由 AVRCP Absolute Volume 与 HFP Remote Audio Volume Control 完成。

  

1.1 机制对比

项目	媒体音量（A2DP 播放）	通话音量（SCO/eSCO）
控制协议	AVRCP Absolute Volume	HFP Remote Audio Volume Control / Volume Level Synchronization
典型角色	手机/音源：CT Controller；音箱、耳机：TG Target	手机：AG Audio Gateway；音箱、耳机：HF Hands-Free
协议值	0x00~0x7F 对应最大音量的 0%~100%，bit7 保留；TG 可按自身档位量化	0~15 的绝对增益等级；每一级对应的实际声压由 HF 实现决定
手机到设备	SetAbsoluteVolume	+VGS:<gain>
设备到手机	EVENT_VOLUME_CHANGED 通知	AT+VGS=<gain>
建立条件	双方支持 AVRCP Absolute Volume；A2DP 本身不提供音量同步	已建立 HFP Service Level Connection；不要求 SCO 音频链路已经建立

1.2 媒体音量：AVRCP Absolute Volume

场景	规范机制	结论
手机设置音量	CT 发送 SetAbsoluteVolume； TG 调整渲染端音量，并在响应中返回“实际设置值”。 由该命令造成的变化不得再完成 EVENT_VOLUME_CHANGED，避免回环。	手机 UI 与设备使用同一绝对音量状态；返回值必须反映设备实际可实现的档位。
设备本地按键/MCU 设置	CT 先用 RegisterNotification(EVENT_VOLUME_CHANGED) 注册。 TG 先回 INTERIM 当前值； 本地音量真正变化后回一次 CHANGED，CT 收到后应重新注册。	通知是一次性的；在最大/最小档继续按键而音量未变化时，不应发送 CHANGED。
连接初始化	规范未规定“手机缓存优先”或“设备缓存优先”。 能力查询、事件注册和初始 SetAbsoluteVolume 的具体时序由 CT 平台实现。	安卓按设备保存音量属于操作系统策略，不是 AVRCP 的强制行为；不能把手机始终作为固定初始化主方。
不支持 Absolute Volume	没有跨设备的绝对音量状态。 手机和设备只能各自调节自身增益，或使用相对音量命令。	两端 UI/档位不保证一致；手机是否修改音频流增益属于平台实现，不是 AVRCP 规范结论。

1.3 通话音量：HFP Remote Volume

场景	规范机制	结论
SLC 建立	HF 应使用 AT+VGS 上报当前扬声器增益（同时可用 AT+VGM 上报麦克风增益）。	HFP 1.8 明确由 HF 在 SLC 建立时报告当前值，并非要求手机先下发初始通话音量。
手机设置音量	AG 发送非请求结果码 +VGS:<gain>，要求 HF 设置扬声器增益。	值域为 0~15；HF 负责把协议档位映射为本机实际增益。
设备本地按键/MCU 设置	HF 发送 AT+VGS=<gain> 并等待 OK，持续把当前扬声器增益报告给 AG。	AT+VGS 只报告 HF 当前值，不直接改变 AG 自身的扬声器增益。
保存范围	双方至少在当前 SLC 生命周期内保存增益设置；跨连接持久化由产品和操作系统决定。	不能把“手机按设备缓存”写成 HFP 强制要求。

当 SCO 已连接时，应使用 HFP 机制同步通话扬声器音量，避免同时完成 AVRCP 音量变化通知而产生双通道回报。Windows 经典蓝牙附件指南对此有明确互操作要求。

1.4 当前 SDK 的落地方式

当前选中板级配置同时使能 BT_SUPPORT_MUSIC_VOL_SYNC=1 和 USER_BT_VOLUME_RELAY_ENABLE=1。

JL 作为蓝牙协议与主控 MCU 之间的音量中转，媒体/通话 DAC 使用固定增益；最终可听音量由主控 MCU 应用。

链路	手机到主控 MCU	主控 MCU 到手机	协议值
媒体	AVRCP 回调 set_music_device_volume() 更新镜像，换算为百分比后通过 PL_BT_VOL_SET 上报	PL_EVT_BT_VOL_SET → bt_sync_remote_media_volume() → USER_CTRL_AVCTP_OPID_SEND_VOL	AVRCP 0~127 ↔ MCU 0~100
通话	BT_STATUS_CALL_VOL_CHANGE 更新镜像，换算为百分比后通过 PL_BT_VOL_SET 上报	PL_EVT_BT_VOL_SET → bt_sync_remote_call_volume() → USER_CTRL_HFP_CALL_SET_VOLUME	HFP 0~15 ↔ MCU 0~100
音量加减	PL_BT_VOLUP/PL_BT_VOLDOWN 根据通话状态选择 HFP 音量命令，否则选择 AVRCP 音量同步命令		按当前协议档位步进
初始化	蓝牙栈初始化后依次用 PL_BT_VOL_GET 获取媒体、通话音量；重试失败使用 50%。对应 AVCTP/HFP 通道建立后，如 MCU 值有效，则同步给远端。		后续任一端产生新的有效值时，以最新事件更新镜像并转发

一致性约束：对手机返回或通知的值必须是产品最终实际应用的音量。当前中转模式下，只有主控 MCU 成功应用对应增益，才满足 AVRCP “返回实际设置值”的语义；同时应保留现有回声抑制，避免手机→JL→MCU→JL→手机形成循环。

1.5 小结

结合1.2 和1.3可知，

对于媒体音量：当手机没有开启音量同步时，各自调节自身增益；当手机开启音量同步时，最终音量由被控终端设备调节增益；音量在手机和被控终端均有存储备份；

对于通话音量：始终开启音量同步，由终端设备先上报自身音量，同步后，声音始终由终端设备调节；音量在手机和被控终端均有存储备份；

2 参考规范

• Bluetooth SIG, AVRCP 1.6.2：§5.8、§6.7.2、§6.13。
• Bluetooth SIG, HFP 1.8：§4.29、§4.34。
• Microsoft Bluetooth Classic audio accessory guidelines：AVRCP Volume 与 HFP/AVRCP 音量互操作要求。