Volume 体系全解：从 VCP 到 AICS 的音量控制

在无线音频的世界里一场静默却深刻的革命正在进行。它就是LE Audio。这不仅仅是一次技术迭代而是从底层重新定义声音如何被创造、传输和体验的范式转移。其复杂性令人敬畏——它并非单一技术而是一套精密的生态系统全新的LC3编解码器以超凡效率重塑音质与功耗的平衡多重串流音频让真无线立体声达到前所未有的稳定与同步而音频广播功能则打破了“一对一”连接的百年窠臼让声音如电台般自由播撒。然而正是这种复杂性构成了我们必须深入学习它的不可辩驳的理由。未来的声音图景将由它绘制从下一代真无线耳机、无障碍助听设备到公共场所的沉浸式音频导览、多语言广播乃至元宇宙中清晰无缝的语音交互。不了解LE Audio将意味着在即将到来的音频浪潮中失去对话的基石。这不仅仅关乎技术本身更关乎我们如何连接彼此如何感知世界。让我们共同开启这段探索之旅揭开LE Audio的复杂面纱看清它为何必将成为未来数年里每一个科技从业者、音频爱好者乃至普通用户都无法忽视的关键命题。接下来的系列文章我们将逐步拆解这座精妙的技术大厦。同时我也录制了一系列的Le audio视频有兴趣的可以咨询我会带领你们入门Le audio翻过大山眼下皆是风景------------------------------------------------------------------------------------------------------------------------------------------视频链接https://item.taobao.com/item.htm?id1001969040805mi_id000032T4qZX9WZoRwX6YbxlNUaZOfOI6XoxDx0jxsfnwlEcspma21xtw.29178619.0.0---------------------------------------------------------------------------------------------------------------------------------目录LE Audio 音量体系概览VCS主音量控制VOCS音量偏移控制AICS音频输入控制VCP 角色与流程多设备音量同步实战代码示例LE Audio 音量体系概览三层音量控制架构┌─────────────────────────────────────────────────────────┐ │ 第一层: 主音量控制 (VCS) │ │ ├─ Volume Setting: 0-255 │ │ ├─ Mute State: Unmuted/Muted/Disabled │ │ └─ 作用于整个设备 │ ├─────────────────────────────────────────────────────────┤ │ 第二层: 音量偏移 (VOCS) │ │ ├─ Volume Offset: -255 ~ 255 │ │ ├─ 独立控制每个输出 │ │ └─ 可用于平衡多扬声器 │ ├─────────────────────────────────────────────────────────┤ │ 第三层: 输入增益 (AICS) │ │ ├─ Gain Setting: 根据设备定义 │ │ ├─ Gain Mode: Manual/Automatic │ │ └─ 控制麦克风输入增益 │ └─────────────────────────────────────────────────────────┘Profile 关系VCP (Volume Control Profile) ├── VCS (Volume Control Service) │ ├── Volume State (Volume Setting Mute Change Counter) │ ├── Volume Flags (Persisted, etc.) │ └── Volume Control Point │ ├── VOCS (Volume Offset Control Service) × N │ ├── Volume Offset State │ ├── Audio Location │ └── Volume Offset Control Point │ └── AICS (Audio Input Control Service) × N ├── Audio Input State (Gain Mute Mode) ├── Gain Setting Properties ├── Audio Input Type └── Audio Input Control PointVCS主音量控制Volume State 结构typedef struct { uint8_t volume_setting; // 0-255, 255 100% uint8_t mute; // 0Not Muted, 1Muted, 2Disabled uint8_t change_counter; // 状态同步计数器 } vcs_volume_state_t;Volume Setting值范围: 0 - 255 常用参考值: 0 静音 64 25% 128 50% 192 75% 255 100% 注意: 实际音量曲线由设备实现决定可能是线性或对数Mute 状态typedef enum { MUTE_NOT_MUTED 0x00, // 未静音 MUTE_MUTED 0x01, // 已静音 MUTE_DISABLED 0x02, // 静音功能被禁用 } vcs_mute_t;Volume Control Point 操作typedef enum { VCS_OP_RELATIVE_VOLUME_DOWN 0x00, // 音量减一步 VCS_OP_RELATIVE_VOLUME_UP 0x01, // 音量增一步 VCS_OP_UNMUTE_RELATIVE_VOLUME_DOWN 0x02, // 解除静音并减 VCS_OP_UNMUTE_RELATIVE_VOLUME_UP 0x03, // 解除静音并增 VCS_OP_SET_ABSOLUTE_VOLUME 0x04, // 设置绝对音量 VCS_OP_UNMUTE 0x05, // 解除静音 VCS_OP_MUTE 0x06, // 静音 } vcs_control_op_t;Volume Flagstypedef struct { uint8_t volume_setting_persisted : 1; // 音量是否持久化 uint8_t reserved : 7; } vcs_volume_flags_t;VOCS音量偏移控制为什么需要 VOCS场景: 多扬声器系统场景: 家庭影院 ┌─────────────────────────────────────┐ │ 手机 (Controller) │ │ Volume 80% │ └──────────────────┬──────────────────┘ │ ┌───────────────┼───────────────┐ ↓ ↓ ↓ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ 左前置 │ │ 中置 │ │ 右前置 │ │ 0dB │ │ 2dB │ │ 0dB │ └─────────┘ └─────────┘ └─────────┘ 每个扬声器可以独立调节偏移量 实现声场平衡Volume Offset Statetypedef struct { int16_t volume_offset; // -255 ~ 255 uint8_t change_counter; } vocs_offset_state_t; // 偏移量解释 // -255 -100% 相对偏移 // 0 无偏移 // 255 100% 相对偏移 // 实际音量 主音量 偏移量设备实现相关Audio Locationtypedef enum { AUDIO_LOCATION_FRONT_LEFT 0x00000001, AUDIO_LOCATION_FRONT_RIGHT 0x00000002, AUDIO_LOCATION_FRONT_CENTER 0x00000004, AUDIO_LOCATION_LOW_FREQ_EFFECT 0x00000008, AUDIO_LOCATION_BACK_LEFT 0x00000010, AUDIO_LOCATION_BACK_RIGHT 0x00000020, AUDIO_LOCATION_SIDE_LEFT 0x00000400, AUDIO_LOCATION_SIDE_RIGHT 0x00000800, // ... 更多位置定义 } audio_location_t;Audio Output Description// 用户可读的输出描述 // 例如: Left Speaker, Right Earbud, Subwoofer char output_description[64];AICS音频输入控制输入类型 (Audio Input Type)typedef enum { AICS_INPUT_TYPE_UNSPECIFIED 0x00, AICS_INPUT_TYPE_BLUETOOTH 0x01, // 蓝牙输入 AICS_INPUT_TYPE_MICROPHONE 0x02, // 麦克风 AICS_INPUT_TYPE_AUXILIARY 0x03, // 辅助输入 AICS_INPUT_TYPE_LOCAL 0x04, // 本地输入 // 0x05-0xFE: Reserved // 0xFF: RFU } aics_input_type_t;Audio Input Statetypedef struct { int8_t gain_setting; // 增益值设备定义范围 uint8_t mute; // 0Not Muted, 1Muted, 2Disabled uint8_t gain_mode; // 0Manual, 1Automatic uint8_t change_counter; } aics_input_state_t;Gain Setting Propertiestypedef struct { uint8_t gain_units; // 增益单位 (0.1dB, 1dB, etc.) int8_t gain_setting_min; // 最小增益 int8_t gain_setting_max; // 最大增益 } aics_gain_properties_t; // 示例配置 // Units: 1 dB // Min: -20 dB // Max: 20 dB // Range: 41 steps (0.5dB per step in some devices)Gain Modetypedef enum { GAIN_MODE_MANUAL 0x00, // 手动增益 GAIN_MODE_AUTOMATIC 0x01, // AGC 自动增益控制 } aics_gain_mode_t;Audio Input Control Pointtypedef enum { AICS_OP_SET_GAIN_SETTING 0x01, AICS_OP_UNMUTE 0x02, AICS_OP_MUTE 0x03, AICS_OP_SET_MANUAL_MODE 0x04, AICS_OP_SET_AUTOMATIC_MODE 0x05, } aics_control_op_t; // Set Gain Setting 参数 typedef struct { uint8_t change_counter; int8_t gain_setting; } aics_set_gain_param_t;VCP 角色与流程角色定义┌─────────────────────────────────────────┐ │ Volume Renderer │ │ (音量渲染器) │ │ ├─ 耳机、音箱、助听器 │ │ ├─ 实现 VCS/VOCS/AICS Server │ │ └─ 实际执行音量调节 │ └─────────────────────────────────────────┘ ▲ │ GATT Read/Write/Notify │ ┌─────────────────────────────────────────┐ │ Volume Controller │ │ (音量控制器) │ │ ├─ 手机、平板、电视 │ │ ├─ 实现 VCS/VOCS/AICS Client │ │ └─ 发送音量控制命令 │ └─────────────────────────────────────────┘发现流程Volume Controller Volume Renderer │ │ │─── Discover VCS ────────────────▶│ │◄──────────── Success ────────────│ │ │ │─── Read Volume State ───────────▶│ │◄────────── Volume128, Mute0 ───│ │ │ │─── Subscribe Volume State ──────▶│ │◄────────── Notification Enabled ─│ │ │ │─── Discover VOCS (instances) ───▶│ │◄────────── VOCS 0, 1, 2 found ───│ │ │ │─── Read VOCS State ─────────────▶│ │◄────────── Offset0, LocationL ─│ │ │ │─── Discover AICS (instances) ───▶│ │◄────────── AICS 0, 1 found ──────│ │ │ │─── Read AICS State ─────────────▶│ │◄────────── Gain10, Mute0 ──────│音量控制流程【设置绝对音量】 Controller Renderer │ │ │─── Write Volume Control Point ───▶│ │ OP: Set Absolute Volume │ │ Volume: 192 (75%) │ │◄─────────── Success ──────────────│ │ │ │◄────────── Notify: Volume192 ────│ State changed │ │ │ 实际音量调节到 75% │ 【相对音量调节】 Controller Renderer │ │ │─── Write Volume Control Point ───▶│ │ OP: Relative Volume Up │ │◄─────────── Success ──────────────│ │ │ │◄────────── Notify: Volume200 ────│ │ │ 【静音控制】 Controller Renderer │ │ │─── Write Volume Control Point ───▶│ │ OP: Mute │ │◄─────────── Success ──────────────│ │ │ │◄────────── Notify: Mute1 ────────│ │ │ │ 设备静音 │多设备音量同步场景TWS 耳机音量同步问题: 调节左耳音量右耳如何同步 方案1: CSIP Ordered Access ┌─────────┐ ┌─────────┐ │ 手机 │ │ 左耳 │ │ (CAP │ │ (Set │ │Commander)│ │Member 1)│ └────┬────┘ └─────────┘ │ │ │─── Lock Set ────────────────▶│ │ │ │─── Set Volume (Ordered) ────▶│──┐ │ │ │ │◄────────── Success ──────────│ │ │ │ │ │─── Set Volume (Ordered) ───────┼──▶┌─────────┐ │ │ │ │ 右耳 │ │◄────────── Success ─────────────┘ │ (Set │ │ │ │Member 2)│ │─── Unlock Set ────────────────────▶└─────────┘ │ │ └──────────────────────────────────┘ 方案2: CAP Acceptor ┌─────────┐ ┌─────────┐ │ 左耳 │◄─── 音量调节 ─────│ 手机 │ │ (CAP │ │ (CAP │ │Acceptor)│◄─── 同步命令 ─────│Commander)│ └────┬────┘ └────┬────┘ │ │ └──────── 同步 ─────────────▶└────────▶┌─────────┐ │ 右耳 │ │ (CAP │ │Acceptor) │ └─────────┘Change Counter 同步TWS 左右耳音量同步机制: 1. 手机设置左耳音量 128 - 左耳 Volume State Notify (Counter5) 2. 手机设置右耳音量 128 - 右耳 Volume State Notify (Counter5) 3. 如果左右耳 Change Counter 不一致 - 表示有设备未同步 - 需要重新读取状态实战代码示例初始化 VCP#include vcp.h static vcp_callbacks_t vcp_cbs { .discover_complete on_vcp_discovered, .volume_state_changed on_volume_changed, .offset_changed on_offset_changed, .gain_changed on_gain_changed, }; void vcp_init(void) { int err vcp_init(vcp_cbs); if (err) { printf(VCP init failed: %d\n, err); return; } }发现音量服务void discover_volume_service(bap_conn_handle_t conn) { vcp_handle_t vcp; int err vcp_discover(conn, vcp, on_vcp_discovered, NULL); if (err) { printf(VCP discover failed: %d\n, err); return; } } void on_vcp_discovered(vcp_handle_t vcp, int err, void *user_data) { if (err) { printf(VCP discovery failed\n); return; } printf(VCP discovered\n); // 读取当前音量状态 vcs_volume_state_t state; vcp_get_volume_state(vcp, state); printf(Current volume: %d, Mute: %d\n, state.volume_setting, state.mute); }设置音量void set_volume(vcp_handle_t vcp, uint8_t volume) { int err vcp_set_absolute_volume(vcp, volume, on_volume_set, NULL); if (err) { printf(Set volume failed: %d\n, err); return; } } void on_volume_set(int err, void *user_data) { if (err) { printf(Volume set failed\n); } else { printf(Volume set successfully\n); } } void on_volume_changed(vcp_handle_t vcp, const vcs_volume_state_t *state, void *user_data) { printf(Volume changed: %d, Mute: %d\n, state-volume_setting, state-mute); // 更新 UI ui_update_volume(state-volume_setting); }设置音量偏移void set_output_volume(vcp_handle_t vcp, uint8_t output_id, int16_t offset) { int err vcp_set_volume_offset(vcp, output_id, offset, on_offset_set, NULL); if (err) { printf(Set offset failed: %d\n, err); } } void on_offset_changed(vcp_handle_t vcp, uint8_t output_id, int16_t offset, void *user_data) { printf(Output %d offset changed: %d\n, output_id, offset); }输入增益控制void set_microphone_gain(vcp_handle_t vcp, uint8_t input_id, int8_t gain) { int err vcp_set_input_gain(vcp, input_id, gain, on_gain_set, NULL); if (err) { printf(Set gain failed: %d\n, err); } } void mute_microphone(vcp_handle_t vcp, uint8_t input_id) { int err vcp_set_input_mute(vcp, input_id, true, on_mute_set, NULL); if (err) { printf(Mute failed: %d\n, err); } } void on_gain_changed(vcp_handle_t vcp, uint8_t input_id, int8_t gain, void *user_data) { printf(Input %d gain changed: %d dB\n, input_id, gain); }常见问题Q1: 音量调节没反应检查点:VCS 是否发现成功Change Counter 是否匹配是否有其他设备在控制Q2: 左右耳音量不同步解决方案:使用 CSIP 协调集锁定使用 CAP Commander 统一控制检查 Change Counter 同步Q3: 麦克风增益调节范围注意:增益范围由设备定义AICS Gain Properties可能是 -20dB ~ 20dB也可能是 0 ~ 100抽象值需要读取 Gain Properties 确定范围总结VCP 三层控制层级服务控制对象范围主音量VCS整个设备0-255音量偏移VOCS每个输出-255 ~ 255输入增益AICS每个输入设备定义关键概念Change Counter: 状态同步机制Volume Rendering: 实际执行音量调节的设备Ordered Access: 协调集音量同步Gain Mode: 手动/自动增益控制