AIDL 和 HIDL 音频 HAL 比较

从 Android 14 开始，我们鼓励合作伙伴和 SoC 供应商使用 AIDL HAL 实现替换当前的 HIDL HAL 实现。

为了方便从 HIDL 音频 HAL 到 AIDL 音频 HAL 的平滑过渡，本页重点介绍了其中的一些主要差异。本页还展示了音频 HAL 的 AIDL 和 HIDL 接口之间的映射。

AIDL 和 HIDL 音频 HAL 实现之间的差异

HIDL 结构和 AIDL 结构之间的主要差异如下：

  • 在 AIDL 音频核心 HAL 中，引入了 IConfig 接口，以替代 HIDL HAL 中 XML 文件中的系统级参数。框架从核心 HAL 而不是供应商配置文件中读取这些参数。例如，核心 HAL 中的 IConfig.getSurroundSoundConfig 方法提供了为用户控制显示的环绕声格式列表。

    在 AIDL 音频效果 HAL 中，HIDL 效果 HAL 中 XML 文件中定义的 effectProxy 逻辑已移至音频框架。音频框架使用 IFactory.queryEffects 查询系统中的所有效果实例，并使用 IFactory.queryProcessing 查询所有效果处理。

  • 为了避免将术语 *device* 用于音频设备类型时产生混淆，HIDL 音频 HAL 中的 IDevice 在 AIDL 音频 HAL 中重命名为 IModule。

  • IPrimaryDevice 在 AIDL 音频 HAL 中被替换。有关当前音频模式和屏幕旋转的更新将发送到每个 IModule 实例。与蓝牙同步连接定向 (BT SCO) 和免提配置文件 (HFP) 相关的参数由专用的 IBluetooth 接口处理。专用的 ITelephony 接口提供特定于电话的控件。这两个接口的实例都可以从 IModule 接口的主要实例中检索。有关详细信息，请参阅 核心 HAL 和 与功能相关的功能 上的比较表。

  • IDevicesFactory 在 AIDL 音频 HAL 中被删除，以避免冗余。HAL 模块（即 IModule 接口实例）现在直接使用其名称（例如 bluetooth 或 r_submix）作为实例名称在 Service Manager 中注册。唯一的例外是 primary 模块，它在实例名称 default 下注册。

AIDL 和 HIDL 音频 HAL 映射

以下各节中的表格显示了 HIDL 和 AIDL 音频 HAL 接口之间的映射。有关目录结构的更多信息，请参阅 Audio HAL README 文件。

核心 HAL

所有 HIDL 接口都在 android.hardware.audio@N.M 软件包中，其中 N.M 表示 主版本号.次版本号 版本。所有 AIDL 接口都在 android.hardware.audio.core 软件包中。

HIDL API 接口和配置文件 AIDL API 接口
IDevicesFactory IModule 在 ServiceManager 中的注册。
IDevice IModule
IPrimaryDevice ITelephony
IBluetooth
IStream
IStreamIn
IStreamOut		 StreamDescriptor
IStreamIn
IStreamCommon
IStreamOut
audio_policy_configuration.xml
audio_policy_engine_configuration.xml		 IConfig
IModule
可配置音频政策文件 针对 Android 14 使用 HIDL 实现。

音频端口、动态配置文件、路由和补丁

在此表中，XML 文件的元素使用尖括号表示。

HIDL API 接口方法和配置文件元素 AIDL API 接口方法
<attachedDevices>
<defaultOutputDevice>
<mixPorts>
<devicePorts>		 IModule.getAudioPorts
IDevice.getAudioPort
IDevice.setConnectedState		 IModule.getAudioPort
IModule.connectExternalDevice
IModule.disconnectExternalDevice
IStream.getSupportedProfiles IModule.connectExternalDevice
<routes> IModule.getAudioRoutes
IDevice.createAudioPatch
IDevice.updateAudioPatch
IDevice.releaseAudioPatch
IStream.getDevices
IStream.setDevices
在 IDevice.openInputStream 中指定设备
IDevice.openOutputStream		 IModule.setAudioPatch
IModule.setAudioPortConfig
IModule.resetAudioPatch

音频端口配置和数据流

HIDL API 接口方法 AIDL API 接口方法
IStream.getAudioProperties
IStream.setAudioProperties
IStreamIn.getAudioSource		 IModule.getAudioPortConfigs
IModule.setAudioPortConfig
IDevice.openInputStream
IDevice.openOutputStream
IStreamIn.prepareForReading
IStreamOut.prepareForWriting
IStream.createMmapBuffer		 IModule.openInputStream
IModule.openOutputStream
IStream.close IStreamCommon.close
IStreamIn.updateSinkMetadata
IStreamOut.updateSourceMetadata		 IStreamIn.updateMetadata
IStreamOut.updateMetadata
IStream.standby StreamDescriptor.Command.standby
IStream.pause
IStream.resume
IStream.start
IStream.stop		 StreamDescriptor.Command.pause
.start
.start
.drain
IStreamOut.drain
IStreamOut.flush		 StreamDescriptor.Command.drain
.flush
IStreamOut.setCallback
IStreamOut.clearCallback		 IModule.openOutputStream
IStreamCommon.close
IStreamOut.getPresentationPosition 和 IStreamIn.getCapturePosition
IStreamOut.getLatency
IStream.getMmapPosition
IStreamIn.getInputFramesLost		 StreamDescriptor.Reply.observable
StreamDescriptor.Reply.latencyMs
StreamDescriptor.Reply.hardware
StreamDescriptor.Reply.xrunFrames
IDevice.getInputBufferSize
IStreamOut.getLatency
IStream.getBufferSize
IStream.getFrameSize
IStream.getFrameCount		 IModule.setAudioPatch、标称延迟和最小缓冲区大小是 HAL 返回的 AudioPatch 结构的一部分。帧中的实际缓冲区大小是 StreamDescriptor 结构的一部分，以及字节为单位的帧大小。字节为单位的缓冲区大小可以通过将这两个数字相乘来计算。

音频效果连接

HIDL API 接口方法 AIDL API 接口方法
IDevice.addDeviceEffect
IDevice.removeDeviceEffect		 IModule.addDeviceEffect
IModule.removeDeviceEffect
IStream.addEffect
IStream.removeEffect		 IStreamCommon.addEffect
IStreamCommon.removeEffect

系统级配置

先前在音频政策 XML 配置文件（即 audio_policy_configuration.xml 和 audio_policy_engine_configuration.xml）中定义的系统级配置必须通过 IConfig 提供。但是，为了简化向 AIDL 的过渡，供应商仍然可以选择使用他们之前用于设置系统级配置的相同 XML 文件。IConfig 的参考实现包含使用 AIDL 数据类型表示来自 XML 文件的信息所需的代码，这有助于从 XML 转换为 AIDL。

HIDL 配置文件元素 AIDL API 接口方法
<globalConfiguration>
<speaker_drc_enabled>1

<call_screen_mode_supported>
<engine_library>		 分为两种不同的方法
ITelephony.getSupportedAudioModes
IConfig.getEngineConfig
<volumes>，或
<volumeGroups>、<ProductStrategies>		 IConfig.getEngineConfig
<surroundSound> IConfig.getSurroundSoundConfig

  1. speaker_drc_enabled 已从配置文件中删除，因为此配置项在系统中未使用。所有设备都必须启用 DRC。 

与功能相关的功能

HIDL API 接口方法 AIDL API 接口
IDevice.setMasterVolume
IDevice.getMasterVolume
IDevice.setMicMute
IDevice.getMicMute
IDevice.setMasterMute
IDevice.getMasterMute		 IModule.\*
IPrimaryDevice.getTtyMode
IPrimaryDevice.setTtyMode
IPrimaryDevice.getHacEnabled
IPrimaryDevice.setHacEnabled
IPrimaryDevice.setVoiceVolume		 ITelephony.TelecomConfig.\*
IPrimaryDevice.setBtScoHeadsetDebugName
IPrimaryDevice.getBtScoNrecEnabled
IPrimaryDevice.setBtScoNrecEnabled
IPrimaryDevice.getBtScoWidebandEnabled
IPrimaryDevice.setBtScoWidebandEnabled,
IPrimaryDevice.getBtHfpEnabled
IPrimaryDevice.setBtHfpEnabled
IPrimaryDevice.setBtHfpSampleRate
IPrimaryDevice.setBtHfpVolume		 IBluetooth.ScoConfig.\*
IBluetooth.HfpConfig.\*
IPrimaryDevice.setMode
IPrimaryDevice.updateRotation		 ITelephony.switchAudioMode
IModule.updateAudioMode
IModule.updateScreenRotation
IDevice.setScreenState
IDevice.getMicrophones		 IModule.updateScreenState
IModule.getMicrophones
IDevice.getHwAvSync
IStream.setHwAvSync		 IModule.generateHwAvSyncId
IStreamCommon.updateHwAvSyncId
IStreamIn.setGain
IStreamIn.setMicrophoneDirection
IStreamIn.setMicrophoneFieldDimension		 IStreamIn.setHwGain
IStreamIn.setMicrophoneDirection
IStreamIn.setMicrophoneFieldDimension
IStreamOut.getDualMonoMode
IStreamOut.setDualMonoMode
IStreamOut.getPlaybackRateParameters
IStreamOut.setPlaybackRateParameters
IStreamOut.selectPresentation
IStreamOut.getAudioDescriptionMixLevel
IStreamOut.setAudioDescriptionMixLevel
IStreamOut.setLatencyMode
IStreamOut.getRecommendedLatencyModes		 IStreamOut.\*
IStreamOut.setEventCallback
IStreamOut.setLatencyModeCallback		 IModule.openOutputStream（回调已合并到 IStreamOutEventCallback 中）
IDevice.get/setParameters
IStream.get/setParameters		 IModule.get/setVendorParameters
IStreamCommon.get/setVendorParameters

已过时的方法

HIDL API 接口方法 注释
IDevice.initCheck
IDevice.close		 HAL 模块仅在成功初始化时才使用 ServiceManager 发布自身。此时，它被认为是永久性的，无法关闭。
IDevice.supportsAudioPatches
IStreamOut.supportsPauseAndResume
IStreamOut.supportsDrain		 必须支持补丁、暂停、恢复和排空。
IStreamOut.getRenderPosition
IStreamOut.getNextWriteTimestamp		 已过时。

供应商扩展

在 HIDL API 中，供应商扩展使用 IDevice 和 IStream 接口中的 getParameters 或 setParameters 方法实现。这些方法接受任意字符串。在 AIDL API 中，有对应的方法，例如 getVendorParameters 或 setVendorParameters，它们通过封装在 ParcelableHolders 中来获取任意 Parcelable 实例。

其他更改

其他一般更改如下：

  1. 为了提高 HAL API 的可测试性，在 AIDL 版本中，我们引入了 VTS 测试使用的调试选项，这些选项可通过 ModuleDebug parcelable 获得。这些选项指示 HAL 模拟某些功能（例如，外部设备的连接），否则这些功能需要手动干预和使用外部测试设备。

  2. 当系统属性 sys.audio.restart.hal 的值设置为 1 时，需要重启 HAL 服务。重启通过 audioserver.rc 实现。在实现 HAL 时，请使用 audioserver.rc 文件中列出的相应 HAL 服务名称。在 Android 14 中，名称 vendor.audio-hal-aidl 是专门为 AIDL 版本的 HAL 添加的。

效果 HAL

所有 HIDL 接口都在 android.hardware.audio.effect@N.M* 软件包中，其中 N.M 是 主版本号.次版本号。所有 AIDL 接口都在 android.hardware.audio.effect 软件包中。

HIDL API 接口和配置文件 AIDL API 接口
IEffectsFactory IFactory
IEffect IEffect
audio_effects.xml IEffect

效果工厂

HIDL API 接口
(android.hardware.audio.effect@X.X)		 AIDL API 接口
(android.hardware.audio.effect)
IEffectsFactory.getAllDescriptors IFactory.queryEffects，使用 null UUID 参数
IEffectsFactory.getDescriptor IFactory.queryEffects，使用 UUID 参数
IEffectsFactory.createEffect IFactory.createEffect
audio_effects.xml IFactory.queryProcessing
IFactory.queryEffects

效果接口

HIDL API 接口
(android.hardware.audio.effect@X.X)		 AIDL API 接口
(android.hardware.audio.effect)
IEffect.init IEffect.open
IEffect.setConfig IEffect.setParameter
IEffect.enable IEffect.command(CommandId::START)
IEffect.disable IEffect.command(CommandId::STOP)
IEffect.reset IEffect.command(CommandId::RESET)
IEffect.getDescriptor IEffect.getDescriptor
IEffect.command 映射到 IEffect.command、
IEffect.setParameter 或
基于旧版 HIDL 命令类型的 IEffect.getParameter
不适用 IEffect.getState
IEffect.setParameter IEffect.setParameter
IEffect.getParameter IEffect.getParameter

效果命令

HIDL API 接口
(android.hardware.audio.effect@X.X)		 AIDL API 接口
(android.hardware.audio.effect)
EFFECT_CMD_INIT IEffect.open
EFFECT_CMD_RESET CommandId.RESET
EFFECT_CMD_ENABLE IEffect.command(CommandId::START)
EFFECT_CMD_DISABLE IEffect.command(CommandId::STOP)
EFFECT_CMD_SET_PARAM_DEFERRED 在 Effects AIDL HAL 中已弃用
EFFECT_CMD_SET_PARAM_COMMIT 在 Effects AIDL HAL 中已弃用
EFFECT_CMD_SET_CONFIG
EFFECT_CMD_SET_PARAM
EFFECT_CMD_SET_DEVICE
EFFECT_CMD_SET_VOLUME
EFFECT_CMD_SET_AUDIO_MODE
EFFECT_CMD_SET_CONFIG_REVERSE
EFFECT_CMD_SET_INPUT_DEVICE
EFFECT_CMD_SET_FEATURE_CONFIG
EFFECT_CMD_SET_AUDIO_SOURCE 		IEffect.setParameter
EFFECT_CMD_GET_PARAM
EFFECT_CMD_GET_CONFIG
EFFECT_CMD_GET_CONFIG_REVERSE
EFFECT_CMD_GET_FEATURE_SUPPORTED_CONFIGS
EFFECT_CMD_GET_FEATURE_CONFIG
VISUALIZER_CMD_MEASURE
EFFECT_CMD_FIRST_PROPRIETARY
（与 VISUALIZER_CMD_CAPTURE 相同）		IEffect.getParameter
EFFECT_CMD_OFFLOAD 已弃用。
在 AIDL 中，卸载和非卸载模式切换在框架中处理。
EFFECT_CMD_DUMP 由内置 binder 事务 AIBinder_dump 处理。

通用效果参数定义

HIDL 定义
(android.hardware.audio.effect@X.X)		 AIDL 定义
Types.hal Flags.aidl
Parameter.aidl

特定效果定义

HIDL API 接口
(android.hardware.audio.effect@X.X)		 AIDL API 接口
(android.hardware.audio.effect)
I$EffectType$.hal $EffectType$.aidl