设备类型限制

本文最后更新于 2024年4月27日晚上

在 Android 音频中，audio_devices_t 用于表示音频设备的类型，且在音频源代码广泛用作位字段来过滤或选择一种或多种特定设备。在 Android 11 之前，音频输入/输出设备的类型数上限为 30，且无法添加新的音频设备类型。我们取消了对音频设备类型数量的限制，以允许添加新的音频设备类型。

为了取消对音频设备类型数量的限制，音频设备类型现在为枚举值，而非位掩码。

所有现有音频设备类型均保持不变。AUDIO_DEVICE_BIT_IN 仍可用于区分输入设备和输出设备。添加的新音频设备类型是枚举值，与现有值之间存在一定的差异。

原始设备制造商 (OEM) 不应将 audio_devices_t 用作位掩码，因为这样做可能会导致在添加新的枚举音频设备类型后产生异常结果。

示例和源代码

在 Android 11 之前，位掩码形式的音频设备类型的用途通常有以下两种。

使用 audio_devices_t 值表示多个音频设备。
检查 audio_devices_t 值是否包含特定类别的音频设备类型。

为了表示多个音频设备类型，可使用 /libaudiofoundation/include/media/AudioContainers.h 中名为 DeviceTypeSet 的类，前者是 audio_devices_t 的 std::set 容器。该类是在面向供应商的 libaudiofoundation 库中声明的。为了表示采用 C 代码的多个音频设备类型，可使用数组或 audio_devices_t 列表。

如需检查某设备类型是否属于特定类别，请使用 /system/media/audio/include/system/audio.h 中的辅助函数 audio_is_.*_device。如果存在多个音频设备类型，请使用 libaudiofoundation 中的辅助函数。例如，使用 AudioContainers.h 中的 areAllOfSameDeviceType (DeviceTypeSet, std::function) 可检查所有特定音频设备类型是否属于同一类型。

实现

原始设备制造商 (OEM) 需要从音频 HAL 实现中移除音频设备类型位字段表示法。

移除位字段中存储的所有设备。

不应使用 audio_devices_t 来表示多个音频设备类型，而应使用列表或矢量。
停止使用位操作对设备类型进行比较。

在 Android 11 之前，可将音频设备类型用作位字段。在这种情况下，通常使用位操作对设备类型进行比较。添加新的枚举音频设备类型时，位操作可能会导致异常结果。请改用辅助函数。如果是单个音频设备类型，则使用直接比较方法比较两个值。如需检查音频设备类型是否属于特定类别，请使用 /system/media/audio/include/system/audio.h 中的辅助函数。例如：audio_is_output_device(audio_devices_t device)。
停止为音频设备类型组使用预定义的值。

system/media/audio/include/system/audio-base-utils.h 中有一些音频设备类型组 AUDIO_DEVICE_OUT_ALL 的预定义的值。这些值都会被保留，但可能会被废弃，因为添加新的枚举音频设备类型后，这些值是错误的。audio-base-utils.h 中定义的新音频设备类型组是音频设备类型的数组（如 AUDIO_DEVICE_OUT_ALL_ARRAY）。
实现create_audio_patch()和release_audio_patch()方法（而非set_parameters）进行路由。

set_parameters 方法将音频设备类型用作位字段，因此，添加新的枚举音频设备类型后可能会出现异常结果。

目前需要使用的音频补丁程序为以下两种：
- 从混音端口到设备端口的补丁程序（用于播放）
- 从设备端口到混音端口的补丁程序（用于录音）
在后续更新中，可能需要从设备到设备的其他补丁程序。

创建音频补丁程序时，如果未指定补丁程序句柄，则音频 HAL 需要生成可标识音频补丁程序的唯一补丁程序句柄。否则，音频 HAL 应使用指定音频补丁程序句柄更新相应音频补丁程序。

如果使用的是旧版音频 HAL 和 AOSP HIDL 封装容器，则旧版音频 HAL 应将主要 HAL 版本设为 3.0。

如需启用音频补丁程序功能，音频 HAL 应将主要 HAL 版本设为 3.0 或更高版本。如需了解详情，请参阅默认 HIDL 实现中的 Device::supportsAudioPatches()，也可以参阅 Cuttlefish 的音频 HAL。

自定义

您无法关闭该功能，也无法还原框架中的音频设备重构以添加音频设备类型。

添加的所有音频设备类型都可以表示设置了单个位的设备类型，因此当前 HAL 实现仍会正常运行。

如果已添加新的音频设备类型，且原始设备制造商 (OEM) 希望使用新类型，则必须升级其音频 HAL 实现并将 HIDL 迁移到 6.0 或更高版本。必须将主要 HAL 版本升级到 3.0 并实现 create_audio_patch 和 release_audio_patch 方法，因为使用 set_parameters 路由音频流可能会导致新添加的音频设备类型时出现异常结果。