Эта страница переведена с помощью Cloud Translation API.

Аудио эффекты

Начиная с 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 аудио и эффектами при включении или отключении эффекта.