Efectos de audio

A partir de Android 11, los fabricantes de dispositivos tienen la capacidad para conectar y habilitar automáticamente efectos de audio específicos cuando se haya para capturar o reproducir audio. Una mejora importante es que los efectos de audio insertados en una ruta de acceso de audio implementada completamente debajo de la HAL de audio (conexión directa entre una entrada (dispositivo de salida y de salida) se pueden controlar con el framework de efectos de audio.

Esta función está dirigida principalmente a OEM de la industria automotriz, pero también se puede usar en otros dispositivos y factores de forma diferentes. Un ejemplo de app es insertar un efecto de mejora de voz en la salida del sintonizador de FM cuando se conecta directamente a la bocina a través del DSP de audio.

Requisitos previos

  • Al igual que con cualquier otro efecto de audio, una biblioteca del proveedor debe implementar el efecto y enumerarlo en el archivo de configuración audio_effects.xml.
  • El efecto debe ser de tipo procesamiento previo o posterior (marca TYPE_PRE_PROC o TYPE_POST_PROC configurada en EffectDescriptor.flags).
  • Si la implementación del efecto es acelerada por hardware (marca HW_ACC_TUNNEL configurada en EffectDescriptor.flags), Se puede adjuntar a una ruta de audio completamente conectada debajo de la HAL (sin reproducción o capturar una transmisión de audio abierta en la HAL de audio).

Cómo crear y habilitar un efecto de dispositivo

Se pueden crear instancias de efectos de audio específicos del dispositivo con uno de los dos métodos que se indican a continuación.

Usa un archivo de configuración de efectos de audio

Este método permite la creación estática de un efecto de audio que se adjunta sistemáticamente. y habilitada para cualquier ruta de audio que seleccione un dispositivo específico como receptor o fuente.

Para ello, agrega una sección específica en el archivo audio_effects.xml de la siguiente manera: 

<deviceEffects>
<devicePort type="AUDIO_DEVICE_IN_BUILTIN_MIC" address="bottom">
      	<apply effect="agc"/>
      </devicePort>
  </deviceEffects>

Usa una API del sistema

Se agregó un nuevo constructor @SystemApi al android.media.audiofx.AudioEffect para crear y habilitar un efecto de dispositivo: 

AudioEffect(@NonNull UUID uuid, @NonNull AudioDeviceAttributes device);

Luego de crear el efecto especificando el ID único de efecto de audio y el descriptor de dispositivo de audio, se puede habilitar o inhabilitar con las APIs de AudioEffect existentes.

También hay una API disponible para consultar si una implementación admite una determinada combinación de dispositivo y efecto. 

static boolean isEffectSupportedForDevice(
            @NonNull UUID uuid, @NonNull AudioDeviceAttributes device);

Nuevas APIs de HAL

HAL de efectos de audio

El HAL de efectos de audio V6.0 tiene una nueva firma para el método createEffect() que permite crear un efecto conectado a un dispositivo: 

IEffectFactory::createEffect(Uuid uid, AudioSession session,
AudioIoHandle ioHandle, AudioPortHandle device)
  • El AudioSession especificado debe ser AudioSessionConsts.DEVICE.
  • Se ignora AudioIoHandle si session es AudioSessionConsts.DEVICE.
  • El device se identifica por su AudioPortHandle único asignado por el framework de audio cuando el dispositivo se selecciona en la HAL de audio con el método IDevice::createAudioPatch().

HAL de audio

Para admitir la función de efectos del dispositivo, el HAL de audio debe implementar el control de enrutamiento de audio con la API de IDevice::createAudioPatch(). Esto lo indica el El método IDevice::supportsAudioPatches() informa true.

Dos métodos de API nuevos, IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId) y IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId), le indican a la implementación de HAL que se habilitó o inhabilitó un efecto de dispositivo en un dispositivo determinado.

El dispositivo se identifica por su ID AudioPortHandle, que se usa cuando se crea un parche de audio con el método IDevice::createAudioPatch().

Una implementación puede usar las API de HAL de audio si se necesita coordinación entre los HAL de audio y efectos cuando un efecto está habilitado o inhabilitado