音量管理

音量管理包含在 CarAudioService 中,它使用固定音量,并且期望通过硬件放大器(而不是在软件中)在 HAL 下应用音量。CarAudioService 会将输出设备划分到不同的音量组,以便对与某个音量组关联的所有设备应用相同的增益。

固定卷

AAOS 实现使用硬件放大器(而非软件混音器)来控制音量。为避免产生副作用,请将 config_useFixedVolume 标志设置为 true(根据需要叠加):

<resources>
    <!-- Car uses hardware amplifier for volume. -->
    <bool name="config_useFixedVolume">true</bool>
</resources>

如果 config_useFixedVolume 标志未设置(或设置为 false),应用可以调用 AudioManager.setStreamVolume(),以在软件混音器中按音频流类型更改音量。这可能并不总是可取的,因为这会对其他应用造成潜在影响,并且软件混音器中的音量衰减会导致在被硬件放大器接收到信号时,信号中的可用有效位减少。

音量组

音量组用于管理音频区内一系列设备的音量。每个音量组的音量均可单独控制。产生的增益会在相关设备上配置,以由车辆放大器应用。音量设置将为用户保留,并在用户登录时加载。

定义音量组

CarAudioService 使用在 car_audio_configuration.xml 中定义的音量组:

<audioZoneConfiguration version="2.0">
    <zones>
        <zone name="primary zone" isPrimary="true">
            <volumeGroups>
                <group>
                    <device address="bus0_media_out">
                        <context context="music"/>
                    </device>
                </group>
                <group>
                    <device address="bus1_navigation_out">
                        <context context="navigation"/>
                    </device>
                    <device address="bus2_voice_command_out">
                        <context context="voice_command"/>
                    </device>
                </group>
                ...
            </volumeGroups>
        </zone>
     </zones>
</audioZoneConfiguration>

每个音量组都应包含一个或多个具有关联地址的输出设备。地址应与 audio_policy_configuration.xml 中定义的输出设备相对应。

配置音量组增益

每个音量组都有最小值、最大值和默认增益值,以及基于 audio_policy_configuration.xml 中为与该音量组关联的设备配置的值而设的步长。

<devicePort tagName="bus0_media_out" role="sink" type="AUDIO_DEVICE_OUT_BUS" address="bus0_media_out">
  <profile name="" format="AUDIO_FORMAT_PCM_16_BIT" samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
  <gains>
    <gain name="" mode="AUDIO_GAIN_MODE_JOINT"
      minValueMB="-3200" maxValueMB="600" defaultValueMB="0" stepValueMB="100"/>
  </gains>
</devicePort>

在初始化期间,音量组会检查关联设备的增益值并按如下方式配置该组:

  • 步长:对于由同一音量组控制的所有设备,都必须保持一致。
  • 最小增益值:组内所有设备的最小增益值。
  • 最大增益值:组内所有设备的最大增益值。
  • 默认增益值:组内所有设备的默认增益值中的最大值。

鉴于这些值的配置方式,可以将音量组的增益设置为超出与该音量组相关联的设备支持的范围。在这种情况下,对于该设备,根据音量组的值是低于还是高于该范围,将增益设置为设备的最小或最大增益值。

音量组标识符

系统会在运行时按照 XML 文件中定义的顺序标识音量组。ID 的范围为音频区中的 0N-1,其中 N 是该区中的音量组数量。这样,音量组 ID 在不同音频区之间不是唯一的。这些标识符用于与音量组关联的 CarAudioManager API。任何接受 groupId 但不带 zoneId 的 API 均默认为主音频区。

多音频区音量管理

每个音频区应该有一个或多个音量组,并且每个音量组仅与一个音频区相关联。此关系在 car_audio_configuration.xml 中定义。如需了解详情,请参阅上文定义音量组中的示例。

每个音频区的当前音量水平会保留给与该音频区关联的用户。这些设置因音频区而异,也就是说,如果用户在与主音频区关联的显示屏上登录,稍后又登录到与辅助音频区关联的音频区,则第一个音频区加载和保持的音量与次要音频区的音量不同。

处理音量键事件

Android 定义了一些用于控制音量的键码,包括:

  • KEYCODE_VOLUME_UP
  • KEYCODE_VOLUME_DOWN
  • KEYCODE_VOLUME_MUTE

默认情况下,Android 会将音量键事件路由到应用。Automotive 实现应强制由 CarAudioService 处理这些按键事件,后者随后会根据需要调用 setGroupVolumesetMasterMute。如需强制实现此行为,请将 config_handleVolumeKeysInWindowManager 标志设置为 true

<resources>
    <bool name="config_handleVolumeKeysInWindowManager">true</bool>
</resources>

音量键事件目前无法区分它们所针对的是哪个音频区,因此系统会假定所有这些事件都与主音频区相关联。收到音量键事件后,CarAudioService 会提取活跃玩家的音频上下文,然后调整包含与最高优先级音频上下文相关联的输出设备的音量组,从而确定要调整的音量组。优先级是根据 CarVolume.AUDIO_CONTEXT_VOLUME_PRIORITY 中定义的固定顺序确定的。

淡变和平衡

两个版本的 AudioControl HAL 都包含用于在车辆中设置淡变和平衡的 API。CarAudioManager 的相应系统 API 会将值传递给 AudioControl HAL。这些 API 需要 android.car.permission.CAR_CONTROL_AUDIO_VOLUME。AudioControl API 包括:

  • setBalanceTowardRight(float value):用于将音响设备音量调向汽车右侧 (+) 或左侧 (-)。

    • 0.0 居中
    • +1.0 完全正确
    • -1.0 完全向左
    • 超出 -1 到 1 范围的值是错误值
  • setFadeTowardFront(float value) 用于将音响设备音量调向汽车前面 (+) 或后面 (-)。

    • 0.0 居中
    • +1.0 完全前进
    • -1.0 表示完全到底层
    • 超出 -1 到 1 范围的值是错误值

您可以决定如何应用这些值以及如何向用户显示值。它们可以严格应用于媒体,也可以全面应用于所有 Android 声音。Android 11 还引入了对将音频效果应用到输出设备的支持。这样一来,就可以通过相应输出设备上的音频效果(而不是通过这些 API)来管理淡变和平衡。

音频闪避

当车辆降低一个声音流的增益,以便可以更清楚地听到同时播放的另一个声音流的声音时,就会发生音频闪避。在 AAOS 中,“降低其他应用音量”由 HAL 实现。Android 无法控制操作系统以外的声音。在 Android 11 中,HAL 做出闪避决策的主要信息是两个输出设备是否都拥有活跃的信息流。

何时闪避

虽然由各个 OEM 来决定 HAL 如何处理闪避,但我们建议遵循以下准则。

  • 当两个应用或服务同时持有音频焦点时,通常会出现 Android 中播放多个声音流的情况。如需了解 Android 何时可以授予并发焦点,请参阅限制类型中的交互矩阵。随着汽车音频插件的引入,这还取决于您的 AudioFocus 管理。

  • 在应用任何增益之前,Android 都会对所有声音流进行混音。因此,在与其他声音流同时播放时应进行闪避处理的输入流都应路由到不同的输出设备,以便 HAL 可以在混音之前应用降低音量功能。

建议为潜在的并发交互降低其他应用音量。

交互 操作
EMERGENCY 将除“SAFETY”以外的所有声音都闪避或静音
SAFETY 闪避除EMERGENCY以外的所有内容
NAVIGATION 闪避除 SAFETYEMERGENCY 之外的所有内容
CALL 闪避除 SAFETYEMERGENCYNAVIGATION 之外的所有内容
VOICE 闪避 CALL_RING
VEHICLE_SOUNDS 您可以确定主动声音的重要性以及它是否会闪避其他声音。
MUSIC”和“ANNOUNCEMENT 一切都被闪避了。例外情况是以 SYSTEM_SOUND 形式播放的触摸互动提示音。

降低其他应用音量时的注意事项

某些应用和服务(如导航或助理)可能会使用多个玩家来执行操作。当数据流停止流经输出设备时,避免过度降低音量,以确保在导航或辅助应用下次开始播放之前媒体不会回到最大音量 3。

如果车辆有多个音场,并且隔离性足够高,您可以将音频路由到汽车的不同区域,而不是降低音量。例如,导航指令可以路由到驾驶员的头枕音箱,同时以正常音量继续在车厢内播放音乐。

对保障安全至关重要的声音

Android 11 引入了 HAL 音频焦点 API。HAL 可确保对保障安全至关重要的声音的优先级高于其他声音。如果 HAL 持有 USAGE_EMERGENCY 的音频焦点,则无法保证 Android 中的应用和服务不会播放声音。HAL 会决定应将来自 Android 的哪些声音流进行混音或静音,以播放对保障安全至关重要的声音。

配置音量设置界面

AAOS 将音量设置界面与音量组配置分离开来。这些信号可以叠加,如配置音量组增益中所述。这种分离可确保即使音量组的配置发生更改,也无需进行任何更改。

在汽车设置界面中,packages/apps/Car/Settings/res/xml/car_volume_items.xml 包含与每个定义的 AudioAttributes.USAGE 相关联的界面元素(标题和图标资源)。此文件通过使用与每个 VolumeGroup 中包含的首个识别出的用法相关联的资源,合理呈现定义的 VolumeGroups

例如,以下示例将 VolumeGroup 定义为包含 voice_communicationvoice_communication_signalling。汽车设置界面的默认实现会使用与 voice_communication 关联的资源呈现 VolumeGroup,因为这是文件中的第一个 matc。

<carVolumeItems xmlns:car="http://schemas.android.com/apk/res-auto">
    <item car:usage="voice_communication"
          car:title="@*android:string/volume_call"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="voice_communication_signalling"
          car:title="@*android:string/volume_call"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="media"
          car:title="@*android:string/volume_music"
          car:icon="@*android:drawable/ic_audio_media"/>
    <item car:usage="game"
          car:title="@*android:string/volume_music"
          car:icon="@*android:drawable/ic_audio_media"/>
    <item car:usage="alarm"
          car:title="@*android:string/volume_alarm"
          car:icon="@*android:drawable/ic_audio_alarm"/>
    <item car:usage="assistance_navigation_guidance"
          car:title="@string/navi_volume_title"
          car:icon="@drawable/ic_audio_navi"/>
    <item car:usage="notification_ringtone"
          car:title="@*android:string/volume_ringtone"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="assistant"
          car:title="@*android:string/volume_unknown"
          car:icon="@*android:drawable/ic_audio_vol"/>
    <item car:usage="notification"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="notification_communication_request"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="notification_communication_instant"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="notification_communication_delayed"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="notification_event"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="assistance_accessibility"
          car:title="@*android:string/volume_notification"
          car:icon="@*android:drawable/ic_audio_ring_notif"/>
    <item car:usage="assistance_sonification"
          car:title="@*android:string/volume_unknown"
          car:icon="@*android:drawable/ic_audio_vol"/>
    <item car:usage="unknown"
          car:title="@*android:string/volume_unknown"
          car:icon="@*android:drawable/ic_audio_vol"/>
</carVolumeItems>

上述配置中使用的属性和值在 packages/apps/Car/Settings/res/values/attrs.xml 中声明。音量设置界面使用以下基于 VolumeGroup 的 CarAudioManager API:

  • getVolumeGroupCount():用于了解应绘制多少个控件。
  • getGroupMinVolume()getGroupMaxVolume():用于获取音量上限和下限。
  • getGroupVolume():用于获取当前音量。
  • registerVolumeChangeObserver():用于接收音量更改通知。

汽车音量组事件

音量更新和静音开关的 Automotive 用例具有上下文基础,可以定义某些应用的操作,例如音量设置。来自车载音频堆栈的当前音量和静音回调仅提供有限的上下文信息。为了更好地服务于汽车用例和未来的可伸缩性,在 Android 14 中添加了 CarVolumeGroupEvent。每个事件都包含三种关键类型的信息:

  • CarVolumeGroupInfo的列表
  • EventTypes(位图)
  • ExtraInfos的列表

CarVolumeGroupInfo

事件回调的接收器可以随时访问受影响的汽车音量组信息列表。这意味着应用无需对汽车音频框架进行任何其他调用即可获取最新状态。只需使用收到的 CarVolumeGroupInfos 即可更新界面或内部状态。为了让应用更轻松地,汽车音量组中变化的方面也会作为 EventTypes 的一部分提供,如下所述。

事件类型

定义 CarVolumeGroupInfo 的哪个方面发生了变化。应用可以借此识别更改并执行所需的操作。例如,EVENT_TYPE_VOLUME_MAX_INDEX_CHANGED 表示各自的 CarVolumeGroups 最大音量增益指数已更改,可通过 CarVolumeGroupInfo.getMaxVolumeGainIndex() 进行查询。

下表显示了 EventTypeCarVolumeGroupInfo 之间的关系。

事件类型 CarVolumeGroupInfo
EVENT_TYPE_VOLUME_GAIN_INDEX_CHANGED CarVolumeGroupInfo.getVolumeGainIndex()
EVENT_TYPE_VOLUME_MIN_INDEX_CHANGED CarVolumeGroupInfo.getMinVolumeGainIndex()
EVENT_TYPE_VOLUME_MAX_INDEX_CHANGED CarVolumeGroupInfo.getMaxVolumeGainIndex()
EVENT_TYPE_MUTE_CHANGED CarVolumeGroupInfo.isMuted()
EVENT_TYPE_VOLUME_BLOCKED_CHANGED CarVolumeGroupInfo.isBlock()
EVENT_TYPE_ATTENUATION_CHANGED CarVolumeGroupInfo.isAttenuated()
EVENT_TYPE_ZONE_CONFIGURATION_CHANGED CarVolumeGroupInfo.getAudioAttributes()

额外信息

提供有关 CarVolumeGroup 更改原因的更多信息。应用可以利用这些信息提供额外的上下文,以提醒用户执行操作或通知。例如,EXTRA_INFO_TRANSIENT_ATTENUATION_THERMAL 表示因热过载而导致的主动瞬态衰减。如果用户尝试调高音量,应用可以通知用户。

我们不会对ExtraInfos强制执行任何流程。您可以自行决定基于 ExtraInfos 的流程。例如,如果衰减因 EXTRA_INFO_TRANSIENT_ATTENUATION_DUCKED 而处于活动状态,您还可以选择在一开始使音量栏界面淡出,以防止用户更改音量。其他应用可能会选择显示一个消息框,说明“降低其他应用音量”功能处于启用状态,并允许用户更改音量。

汽车音频框架依赖 AudioControl HAL IAudioGainCallback 来提供建议的 ExtraInfos。如需了解详情,请参阅音频增益回调

CarVolumeGroupEvent 可以进行扩缩,以满足汽车音频框架的未来需求。我们打算通过 CarVolumeGroupEvent 支持新功能。我们强烈建议应用开发者使用 CarVolumeGroupEvent 来处理群组音量和静音更改。

汽车音量组事件回调

Android 14 为特权应用和平台应用提供了一种新的回调,以便注册该应用并接收 CarVolumeGroupEvents 通知。

  • 如需注册回调,请使用 CarAudioManager#registerCarVolumeGroupEventCallback()

  • 如需取消注册回调,请使用 CarAudioManager#unregisterCarVolumeGroupEventCallback()

如果应用向新的 CarVolumeGroupEventCallback 和旧版 CarVolumeCallback 注册,则事件 CarVolumeGroupEventCallbacks 的优先级更高。汽车音频堆栈不再触发 CarVolumeCallback。这可以防止针对同一事件向同一应用重复触发触发器。

我们强烈建议您使用 CarVolumeGroupEventCallback 管理群组音量和将更改静音。

音频增益回调

从 Android 13 开始,由于车载音频系统发生变化,AudioControl HAL 可以触发异步回调来管理音量更新。

HAL API

AudioControl @2.0 AIDL

2.0 版 AudioControl AIDL HAL 添加了以下 API:

API 目的
IAudioControl#registerGainCallback 向 AudioControl HAL 注册 IAudioGainCallback 的实例。
IAudioGainCallback#onAudioDeviceGainsChanged 用于通知音频增益配置更改的异步回调。

AudioControl HAL 回调包含原因列表和相应的 AudioGainConfigInfo,其中包括:

  • 区域 ID
  • 设备端口地址
  • 卷索引 > 索引可以是受限索引或更新索引。

原因可以大致分为以下几类:

  • 限制原因。音量和静音行为的暂时性变化。
  • 更新原因。卷行为的永久性更改。

限制类型

AudioControl HAL AIDL V3起,受支持的限制类型如下:

  • 忽略
  • 禁播
  • 限制
  • 衰减
有效限制 用户触发的音量变化 用户触发的静音切换开关
忽略 ❌(取消静音)

✔(静音)
禁播
限制 ❌(超出上限)

✔(未达到上限)
衰减

限制之间的优先级为“忽略”>“屏蔽”>“限制”>“衰减”。

忽略限制

忽略限制包括:

  • Reasons.TCU_MUTE
  • Reasons.REMOTE_MUTE

车载音频框架在内部保持以下两种静音状态:

  • 用户忽略。根据用户请求通过 CarAudioManager 或按键事件进行切换。

  • HAL 静音 -根据通过 AudioGain 回调收到的静音限制进行切换。

对于“设置”应用等监听器,音量组整体静音 (CarVolumeGroupInfo.isMuted()) 状态将取决于是否启用了上述任一静音。

启用 HAL 静音功能后,在限制期间,系统会忽略所有传入的音量更改请求和群组取消静音请求。

互动用例:HAL 静音处于启用状态,且用户请求“静音”切换开关

启用 HAL 静音并停用用户静音后:

  • 音量组整体静音状态已更改为 true
  • 系统会处理用户启用忽略功能的请求。
    • 原因:应始终尊重用户忽略的请求,以保护用户隐私。

启用 HAL 静音并启用用户静音后:

  • 音量组整体静音状态已更改为 true

  • 系统会NOT处理用户停用忽略功能的请求。缓存的用户静音状态会保持启用状态。

    • 原因:仅当用户没有有效限制时,系统才会批准用户取消静音请求。

    • 原因:将缓存的用户静音取消静音可能会导致意外声音爆炸并危及用户安全。如果在点火周期内启用静音状态,会降低用户对声音水平感知的认知度,这一点尤为重要。

互动用例:HAL 静音启用和停用,而用户静音没有任何更改

切换 HAL 静音状态会更改音量组的总体静音状态。不过,它不会直接更新用户的静音状态。停用用户静音功能后,如果系统收到要启用的 HAL 静音回调,请执行以下操作:

  • 音量组整体静音状态已更改为 true
  • 启用 HAL 静音后,系统会NOT处理用户发出的音量更改请求。

    • 原因:启用静音后,用户听不到声音。允许音量改变可能会导致声音爆炸,危及用户安全。

    • 原因:音量应用可以注册回调并自动触发取消静音 (CarAudioManager.setVolumeGroupMute(...,/* Mute=*/ true,..)),而无需用户干预(如果这是 OEM 的预期行为)。

如果在停用用户静音功能的情况下停用 HAL 静音:

  • 音量组静音状态已更改为“false”。

    原因:当静音状态频繁切换时,将静音状态设为固定并请求用户取消静音可能会不必要地干扰用户。

  • 系统会正常处理用户提出的更改数量请求。

禁播

屏蔽限制包括:

  • Reasons.FORCED_MASTER_MUTE
  • Reasons.REMOTE_MUTE
  • Reasons.TCU_MUTE.

当屏蔽限制处于启用状态时,用户向以下对象提出的请求:

  • 系统处理更改量。
  • 已处理切换静音操作。

限制

限制限制如下:

  • Reasons.THERMAL_LIMITATION
  • Reasons.SUSPEND_EXIT_VOL_LIMITATION

启用限制限制后,用户将向以下对象发出请求:

  • 调节音量:

    • 在限制范围内
    • 上述限制不会得到处理
  • 已处理切换静音操作。

衰减

衰减限制如下:

  • Reasons.ADAS_DUCKING
  • Reasons.NAV_DUCKING
  • Reasons.PROJECTION_DUCKING

启用衰减限制后,用户将向:

  • 系统会处理更改量。新的当前音量将设为静音音量(而不是先前的音量)。将来的音量更改将从此级别进行。

  • 已处理切换静音操作。

更新为索引

以下内容被视为异步卷索引更新:Reasons.EXTERNAL_AMP_VOL_FEEDBACK

因此,AudioControl HAL 可以将音量组的当前索引更新为指定索引。它主要用作来自车载音频框架的音量更改请求的音频系统反馈。索引更新还会以 CarVolumeGroupEvent 回调的形式与应用进行通信,以同步索引。

示例

用例:用户将音量指数更新为 30

  • 用户使用“音量”应用将音量指数更改为 30。

  • 此索引会转换为音量增益并发送到音频 HAL。

  • Audio HAL 的供应商实现会接收新的音量增益并更新音频系统(如外部放大器)。

  • 音频系统响应音量仅更新为索引 15(出于 Android 未知的原因)。

  • AudioControl HAL 触发器的供应商实现:

    IAudioGainCallback.onAudioDeviceGainsChanged(EXTERNAL_AMP_VOL_FEEDBACK, {...,  15 /* New index */})
    
  • 汽车音频服务会使用回调中的新索引,该索引用于对音量应用进行持久性和回调。用户请求的索引为 30。不过,音频系统异步反馈会将索引更新为 15。

用例:退出挂起后首次播放音频

  • 挂起前的卷索引设置为高级别 95(范围:[0-99])。

  • Android 进入挂起状态。

  • 一旦 Android 存在挂起(例如,恢复):

    • 供应商 Audio HAL/AudioControl HAL 会向本地音频系统应用安全索引 30。

    • 供应商 AudioControl HAL 还会触发安全索引的回调:

    IAudioGainCallback.onAudioDeviceGainsChanged(SUSPEND_EXIT_VOL_LIMITATION, {...,  30 /* safe index */})
    
  • 汽车音频服务会使用来自用于持久化的回调的新索引,以及它自己的对用于同步索引的音量应用的回调。挂起前的卷指数为 95。不过,恢复之后,AudioControl HAL 实现者会将此索引设置为安全音量级别 30。

动态卷配置

对于此功能,我们考虑了以下主要用例:

  1. 车辆停产 (EOL) 配置。

    • 汽车制造商更喜欢在服务终止 (EOL) 时根据车载音频系统设置更新音量配置。通常,这属于旁加载,不会更新 Android 软件映像。

    • 汽车制造商可能需要在服务时间表期间更新音量配置。

  2. 运行时配置 -汽车音频系统支持外部放大器配置,这些 ECU 可以托管启动期间查询的音量范围配置。

  3. 按需配置。旨在满足用户对基于需求的音频功能日益增长的需求。在这类功能中,用户在一段时间内订阅增强型信号处理服务。新的音量范围配置在订阅期内有效。

设计

动态音量配置分三个阶段实现:

  • 发现。供应商 AudioControl HAL 实现通过供应商拥有的自定义 IPC 机制发现新的音量范围更新。

    发现后,会通过 AudioControl::IModuleChangeCallback 生成回调。

  • 更新。汽车音频堆栈会使用新的音量范围更新音量组状态。

    音量范围更新后,我们会尽力保持相同的音量。但是,如果索引超出边界,则当前音量指数会设置为安全值。例如,供应商在回调期间提供的默认级别。

  • Callback

    • 音量组范围更新后,汽车音频堆栈会触发对通过 CarVolumeGroupEventCallback 注册的应用进行回调。

    • CarVolumeGroupEvent 包含更新后的 CarVolumeGroupInfo、事件类型(更改内容)和额外信息(更改原因)。

图片

图 1. 动态卷配置。

HAL API

AudioControl @ 3.0 AIDL

AudioControl AIDL HAL 版本 3.0 引入了以下 API:

API
IAudioControl#setModuleChangeCallback 使用 AudioControl HAL 设置 IModuleChangeCallback 的实例。
IAudioControl#clearModuleChangeCallback 清除之前使用 AudioControl HAL 设置的 IModuleChangeCallback 实例。
IModuleChangeCallback#onAudioPortsChanged 用于通知 AudioPorts 更改的回调

顺序

动态音量配置序列图如下所示。

图片

图 2. 动态音量配置序列图。

主要方面

如需优化此功能,请考虑以下事项。

  • 作为回调的一部分提供的 AudioPort 必须与 Automotive 总线定义匹配:

    • 设备端口IN_DEVICEOUT_DEVICE
    • 连接。 BUS
    • 地址。在音频 HAL 定义中定义
    • 增益模式。 JOINT
  • 供应商必须在音频 HAL 政策中定义音量范围定义的超集,并使用该回调针对车辆变体对其进行自定义。如需了解详情,请参阅 IModuleChangeCallbac AIDL 定义。

  • 如果多个音频总线属于同一音量组,则每个音频总线必须具有相同的音量范围定义。否则,会导致汽车音频框架拒绝新的音量范围定义。