Начиная с Android 11, производители устройств имеют возможность автоматически подключать и включать определенные звуковые эффекты, когда определенное аудиоустройство выбрано для захвата или воспроизведения звука. Одним из основных улучшений является то, что аудиоэффекты, вставленные в аудиотракт, полностью реализованные ниже аудио HAL (прямое соединение между устройством ввода и устройством вывода), могут управляться структурой аудиоэффектов.
Эта функция в первую очередь предназначена для производителей автомобильного оборудования, но ее также можно использовать и в других форм-факторах Android. Пример приложения — вставка эффекта улучшения голоса на выход FM-тюнера при прямом подключении к динамику через аудио DSP.
Предварительные условия
- Как и любой другой звуковой эффект, он должен быть реализован библиотекой поставщика и указан в файле конфигурации
audio_effects.xml
. - Эффект должен иметь тип предварительной или постобработки (флаг
TYPE_PRE_PROC
илиTYPE_POST_PROC
установлен вEffectDescriptor.flags
). - Если реализация эффекта имеет аппаратное ускорение (флаг
HW_ACC_TUNNEL
установлен вEffectDescriptor.flags
), его можно прикрепить к аудиотракту, полностью подключенному ниже HAL (в аудио HAL не открывается аудиопоток воспроизведения или захвата).
Создайте и включите эффект устройства
Звуковые эффекты, специфичные для конкретного устройства, можно создать одним из двух методов, описанных ниже.
Используйте файл конфигурации аудиоэффектов
Этот метод позволяет статически создавать аудиоэффект, который систематически присоединяется и включается к любому аудиотракту, выбирая указанное устройство в качестве приемника или источника.
Это делается путем добавления определенного раздела в файл audio_effects.xml
следующим образом:
<deviceEffects> <devicePort type="AUDIO_DEVICE_IN_BUILTIN_MIC" address="bottom"> <apply effect="agc"/> </devicePort> </deviceEffects>
Используйте системный API
В класс android.media.audiofx.AudioEffect
добавлен новый конструктор @SystemApi для создания и включения эффекта устройства:
AudioEffect(@NonNull UUID uuid, @NonNull AudioDeviceAttributes device);
После создания эффекта путем указания уникального идентификатора аудиоэффекта и дескриптора аудиоустройства его можно включить или отключить с помощью существующих API-интерфейсов AudioEffect.
Также доступен API для запроса, поддерживает ли реализация данную комбинацию устройства/эффекта.
static boolean isEffectSupportedForDevice( @NonNull UUID uuid, @NonNull AudioDeviceAttributes device);
Новые API HAL
Аудиоэффект HAL
Звуковой эффект HAL V6.0 имеет новую сигнатуру метода createEffect()
, позволяющую создавать эффект, прикрепленный к устройству:
IEffectFactory::createEffect(Uuid uid, AudioSession session, AudioIoHandle ioHandle, AudioPortHandle device)
- Указанный
AudioSession
должен бытьAudioSessionConsts.DEVICE
. -
AudioIoHandle
игнорируется, еслиsession
—AudioSessionConsts.DEVICE
. -
device
идентифицируется по уникальномуAudioPortHandle
назначенному аудиоплатформой, когда устройство выбирается в аудио HAL с помощью методаIDevice::createAudioPatch()
.
Аудио ХАЛ
Для поддержки функции эффекта устройства аудио HAL должен реализовать управление маршрутизацией звука с помощью API IDevice::createAudioPatch()
. На это указывает метод IDevice::supportsAudioPatches()
сообщающий true
.
Два новых метода API, IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId)
и IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId)
сообщают реализации HAL о том, что эффект устройства включен или отключен на данном устройстве.
Устройство идентифицируется по идентификатору AudioPortHandle
, который используется при создании аудиопатча с помощью метода IDevice::createAudioPatch()
.
API-интерфейсы Audio HAL могут использоваться реализацией, если требуется координация между HAL аудио и эффектами при включении или отключении эффекта.