文章目录
- 基本概念
- 车载音频配置文件
- 外部的配置音频区的方式
- 车载音频服务配置路由流程
- 框架中获取可用输出设备
- 配置例子
- 测试方法
- 相关问题
基本概念
Android 管理来自 Android 应用的声音,同时控制这些应用,并根据其声音类型将声音路由到 HAL 中的输出设备:整个框架如下图
- 逻辑声音流
使用音频属性进行标记,应用可以有一个或多个通过标准 Android API(如用于控制焦点的 AudioManager或用于在线播放的 MediaPlayer)发出一个或多个音频数据逻辑声音流。应用声音流与 AudioAttributes相关联。逻辑声音流通过 AudioService 发送,并路由到一个(并且只有一个)可用的物理输出声音流。
- 输出设备
在音频 HAL 级别,设备类型 AUDIO_DEVICE_OUT_BUS
提供用于车载音频系统的通用输出设备。总线设备支持可寻址端口(其中每个端口都是一个物理声音流的端点)
音频上下文到输出设备的分配是通过 car_audio_configuration.xml
完成的。
车载音频配置文件
car_audio_configuration.xml文件相关的标签
zone: 定义每个zone的相关信息,对应的是各个分区,如主区域,后座区域1、后座区域2等等。
primary zone: 主音频区, 默认情况下,所有音频都将路由到主音频区。只能有一个主音频区,主音频区通过 isPrimary=“true” 在xml中定义。
zoneId:音频区ID,用于标识不同的音频区。 其中主音频区的 audioZoneId 始终为零。
occupantZoneId:乘客区ID,用于配置基于用户ID 的路由,比如想要每个用户使用不同的音频区 ,需要按照下面例子的方式进行配置。如下例子主音频区ID是0, 乘客区ID 为0, 辅助音频区ID 为1,乘客区ID 为1。其中occupantZoneId需要对应的display有效。
<audioZoneConfiguration version="2.0">
<zone name="primary zone" isPrimary="true" occupantZoneId="0"> ...
</zone>
<zone name="rear seat zone" audioZoneId="1" occupantZoneId="1"> ...
</zone>
</zones>
</audioZoneConfiguration>
audioZoneId 和occupantZoneId 之间的映射关系
-
主音频区的 audioZoneId 始终为零
-
audioZoneId 和 occupantZoneId 的编号不可重复
-
audioZoneId 和 occupantZoneId 之间只能是一对一的映射
group :音量组, 是为了对与相应音量组关联的所有设备应用相同的增益。其负责管理音频区中一系列设备的音量。在每个音量组中,音量均可单独控制,并且产生的增益会在关联的设备上进行配置,以通过相应车载放大器进行应用。音量设置将为用户保留,并在用户登录时加载.
device :设备的地址,group关联的device
context :音频上下文, 在 carAudioService 中的使用,用来定义路由、音量组和音频焦点管理。
外部的配置音频区的方式
-
通过应用UID进行配置
首先获取到需要配置的zoneId,然后利用 CarAudioManager#setZoneIdForUid API 来设置音频路由 -
通过用户ID进行配置默认的方式
CarAudioService 会使用汽车乘员区和音频区之间的映射来定义基于用户 ID 的路由。这样,当用户登录到乘员区时,车载音频服务就会收到通知。收到此信号后,系统会自动为所有音频区配置音频焦点管理和路由。 -
使用 setPreferredDevice 进行路由
Android 11 还新增了下列 API 来查询与各个音频区关联的输出设备:CarAudioManager#getOutputDeviceForUsage(int zoneId, int usage)。该 API 可用于查询用于特定音频区的输出设备以及音频属性用法。通过这种方式,第一方应用便可利用播放器的 setPreferredDevice API,将音频路由到不同的音频区。getOutputDeviceForUsage API 需使用PERMISSION_CAR_CONTROL_AUDIO_SETTINGS,并且是系统 API。以下示例展示了如何查找用于特定音频区的媒体设备以及如何使用 setPreferredDevice API 路由到该设备。
audioZoneId = ... ; mediaDeviceInfo = mCarAudioManager.getOutputDeviceForUsage(audioZoneId, AudioAttributes.USAGE_MEDIA); mPlayer.setPreferredDevice(mediaDeviceInfo);
车载音频服务配置路由流程
- 解析xml 存储到CarAudioZone
- 读取car_audio_configuration.xml 按照xml定义的标签顺序进行解析
- 解析zones标签下面的所有zone,确认只有一个primary的zone,并存储zone 到carAudioZones
- 解析zone标签对应的audioZoneId 和 occupantZoneId,确保occupatZontId 唯一并存储到mZoneIdToOccupantZoneIdMapping
- 依据解析到zone name 和id 创建CarAudioZone,开始解析volumeGroup
- 解析groupID标签,每解析到一个group 对应groupID 加一。同时开始解析group嵌套的device和context。
- 解析groupID下的device标签,device 对应的是address名字,要确认bus address是否在输出的设备中。(如何确认涉及框架)
- 解析device 对应的context,然后根据device的address 获取deviceinfo,然后设置context对应deviceInfo。
- 最后所有的解析到group、device、context的信息会存储到CarAudioZone中
-
同步每个zone的增益相关的信息
通过调用hal adev_set_audio_port_config来实现的,目前这个hal 层 没有实现,zone的增益实际通过设置每个group来设置的。 -
设置audio的动态路由
- 遍历所有的zone对于每个zone 遍历zone中的volumeGroup
- 对于volumeGroup遍历所有address,对应addrss遍历所有的context
- 对于所有的context获取AudioAttributes的usage,一个context可能对应多个usage。对于每个usage 创建一个AudioAttributes,然后将AudioAttributes,和device相关的设置addMix到AudioMix中。
AAOS 提供给外部的是USAGE,而上面的流程是创建了address(device)–> context–>usage的映射关系。 对于应用来说,在用到声音流的地方指定了 AttributeUsages之后,carAudioService就会依据映射关系找到对应要输出的device。context真正对应的是AudioAttributes的usage数组(一个context对应一个usage数组)
AAOS 主要使用AudioAttributes.AttributeUsages 进行路由、音量调整和焦点管理。用法用于表示播放声音流的“原因”。因此,所有声音流和音频焦点请求都应为其音频播放指定用法。如果在构建 AudioAttributes 对象时未明确设置,则用法将默认为 USAGE_UNKOWN。虽然目前会对此用法采取与 USAGE_MEDIA 一样的处理,但不应依赖此行为进行媒体播放。
框架中获取可用输出设备
carAudioService 通过调用AudioManager getDevice来获取设备可用的输出设备
可用的设备在audio_policy_configuration.xml定义,其中attachDevice标签定义的device 同时在device_port中有定义的,并且设备通过hal层open,能够open成功的device 为可用的输出设备
-
audio_policy_configuration.xml解析
-
module 标签对应HWModule,对应的是不同hal库的实现,如primary、usb等等。不同hal库的接口是一样的。上层通过HIDL的接口来调用。
-
MixProt理解为stream流,有对应的profile profile 中配置了格式、采样率、mask、根据type 分为输入和输出流对应为类IOProfile. 其中mSupportedDevices表示
当前流支持的设备集合; * 如果是sink输入流,查找规则如下: * 1. 遍历其父类的成员mRoutes,因为是输入流,所以遍历mRoute集合中sink为自己的route,也就是找有哪些源source设备把数据传给自己。 * 2. 找到route后,根据route中source保存的对象,且对象type是AUDIO_PORT_TYPE_DEVICE类型(就是devicesPort标签对应的实体类DeviceDescriptor) * 3. 把DeviceDescriptor保存在集合中,保存在以下mSupportedDevices中,作为其支持的设备; * 输出流,同理;最终的结果就是: * 作为输出流source,mSupportedDevices保存此流可以输出到对应的device,stream -> device * 作为输入流sink,mSupportedDevices保存了其他device能输出数据到此流, device -> stream
-
DevicePort 标签devicePort标签可以理解为一个device设备,设备也分output和input,但是不在像mixport那样以role来分,而是以type中有关键字“IN”和“OUT”来分 对应实体类DeviceDescriptor, 在这里面也会解析profile
-
标签route route是把deviceport和mixport连接起来的路由,数据由一个stream输出到另一个device,或者从一个device输出到另一个stream
-
配置例子
-
car_audio_configuration.xml
如下的xml配置3个音频区,
第一个是主音频区,其用户ID 为0,占用区域ID为0,定义了4个音量组,音量组的设备有相同的音频增益
音量组定义了两个输出设备,每个输出设置都包含了一组的音频上下文。
第二个是后座区域1,其用户ID 为1,占用区域ID为1,定义了1个音量组,音频组定义了一个输出设备,同样也包含了一组的音频上下文。
第三个是后座区域2,其用户ID 为2,占用区域ID为2,定义了1个音量组,音频组定义了一个输出设备,同样也包含了一组的音频上下文。
如果配置了每个音频区以及各自的占用区域ID,那么在用户登录的时候,比如主区域登录时,对应 的应用的 音频流 会使用zone0的devices。然后根据应用设置AudioAttributes.AttributeUsages 找到context(usages 到context 的映射如下表),比如Usages是MEDIA,那么找到conetxt 是music ,context music 找到对应的bus0_media_out设备。
如果没有配置每个音频区以及各自的用户,那么应用需要知道UID和ZONE ID。
然后通过UID 设置对应应用的音频流到设备。
<?xml version="1.0" encoding="utf-8"?>
<carAudioConfiguration version="2">
<zones>
<zone name="primary zone" isPrimary="true" occupantZoneId="0">
<volumeGroups>
<group>
<device address="bus0_media_out">
<context context="music"/>
<context context="announcement"/>
</device>
<device address="bus6_notification_out">
<context context="notification"/>
</device>
</group>
<group>
<device address="bus1_navigation_out">
<context context="navigation"/>
</device>
<device address="bus2_voice_command_out">
<context context="voice_command"/>
</device>
</group>
<group>
<device address="bus4_call_out">
<context context="call"/>
</device>
<device address="bus3_call_ring_out">
<context context="call_ring"/>
</device>
</group>
<group>
<device address="bus5_alarm_out">
<context context="alarm"/>
</device>
<device address="bus7_system_sound_out">
<context context="system_sound"/>
<context context="emergency"/>
<context context="safety"/>
<context context="vehicle_status"/>
</device>
</group>
</volumeGroups>
</zone>
<zone name="rear seat zone 1" audioZoneId="1" occupantZoneId="1">
<volumeGroups>
<group>
<device address="bus100_audio_zone_1">
<context context="music"/>
<context context="navigation"/>
<context context="voice_command"/>
<context context="call_ring"/>
<context context="call"/>
<context context="alarm"/>
<context context="notification"/>
<context context="system_sound"/>
<context context="emergency"/>
<context context="safety"/>
<context context="vehicle_status"/>
<context context="announcement"/>
</device>
</group>
</volumeGroups>
</zone>
<zone name="rear seat zone 2" audioZoneId="2" occupantZoneId="2">
<volumeGroups>
<group>
<device address="bus200_audio_zone_2">
<context context="music"/>
<context context="navigation"/>
<context context="voice_command"/>
<context context="call_ring"/>
<context context="call"/>
<context context="alarm"/>
<context context="notification"/>
<context context="system_sound"/>
<context context="emergency"/>
<context context="safety"/>
<context context="vehicle_status"/>
<context context="announcement"/>
</device>
</group>
</volumeGroups>
</zone>
</zones>
</carAudioConfiguration>
CarAudioContext | 关联的 AttributeUsages |
---|---|
MUSIC | UNKNOWN, GAME, MEDIA |
NAVIGATION | ASSISTANCE_NAVIGATION_GUIDANCE |
VOICE_COMMAND | ASSISTANT, ASSISTANCE_ACCESSIBILITY |
CALL_RING | NOTIFICATION_RINGTONE |
CALL | VOICE_COMMUNICATION, VOICE_COMMUNICATION_SIGNALING |
ALARM | ALARM |
NOTIFICATION | NOTIFICATION, NOTIFICATION_* |
SYSTEM_SOUND | ASSISTANCE_SONIFICATION |
EMERGENCY | EMERGENCY |
SAFETY | SAFETY |
VEHICLE_STATUS | VEHICLE_STATUS |
ANNOUNCEMENT | ANNOUNCEMENT |
测试方法
- 测试方法总结
上层只需要验证配置的路由是不是正确的。
- 通过kitchensink Audio 这一页面进行不同场景音频路由的测试。里面包含了不同的usage,并能够选择不同的zone。通过播放不同的usage,然后在log中查看是不是找到对应的设备进行输出。比如ASSISTANCE_NAVIGATION_GUIDANCE,对应的地址是bus1_navigation_out。 然后在policy添加log确认,有如下的log输出 说明路由成功了。
APM_AudioPolicyManager: setOutputDevices device {type:0x1000000,@:bus1_navigation_out} delayMs 0
- 不同的userID,通过在不同的显示屏使用music应用,查看路由的设备 确认是不是不同的区域路由不同的设备。music应用只能测试context为music的情况。比如目前上面的配置,在主屏上面使用music播放音乐会路由到bus0_media_out进行播放,而在副屏上面就会路由到bus200_audio_zone_2进行播放。
- 相关的修改
- car_audio_configuration.xml 添加zone,occupation,address,context
- audio_policy_configuration.xml 配置address的device
- overlay 中config.xml 修改audioUseDynamicRouting 为true
相关问题
-
如何配置音频区域
在car_audio_configuration.xml中配置occupantZoneId 和zonID, 这两个一一对应,其中occupantZoneId是用来映射UserID 和DisplayID。 比如car_audio_configuration.xml定义了3个occupantZoneId 分别为0,1,2。就定义了三个音频区相关的配置。需要注意的是如果在config.xml config_occupant_display_mapping 中定义的displayPort=1无效,那么audio对应的occupantZoneId为1的audio zonId也是无效的。
-
音频的ZoneID 如何跟UserID关联起来的
车载音频服务会监听 车载账户的启动。当车载账户启动同时解析到车内成员和显示的映射关系后 会回调到车载音频服务。这边会遍历车载音频配置解析后保存的zoneID和OccupantZoneId的映射数组,从数组中取出zoneID 和 OccupantZoneId,然后从OccupantZoneService通过OccupantZoneId获取到userID,最后构建AudioZoneId 和userID的map。同时也更新路由到audioPolicy 中, 也就是audioplicy这边的路由也保存了userid的信息。 后面应用启动音频播放的时候,audioplicy会主动获取UserID然后匹配对应UserID的路由。