Effets audio

À partir d'Android 11, les fabricants d'appareils ont la possibilité d'associer et d'activer automatiquement des effets audio spécifiques lorsqu'un appareil audio donné est sélectionné pour la capture ou la lecture audio. L'une des principales améliorations est que les effets audio insérés sur un chemin audio entièrement implémenté sous le HAL audio (connexion directe entre un appareil d'entrée et un appareil de sortie) peuvent être contrôlés par le framework d'effets audio.

Cette fonctionnalité est principalement destinée aux équipementiers automobiles, mais elle peut également être utilisée dans d'autres formats Android. Par exemple, une application insère un effet d'amélioration de la voix sur la sortie du tuner FM lorsqu'il est directement connecté au haut-parleur via le DSP audio.

Prérequis

  • Comme pour tout autre effet audio, l'effet doit être implémenté par une bibliothèque de fournisseur et répertorié dans le fichier de configuration audio_effects.xml.
  • L'effet doit être de type prétraitement ou post-traitement (indicateur TYPE_PRE_PROC ou TYPE_POST_PROC défini dans EffectDescriptor.flags).
  • Si l'implémentation de l'effet est accélérée par le matériel (indicateur HW_ACC_TUNNEL défini dans EffectDescriptor.flags), elle peut être associée à un chemin audio entièrement connecté sous le HAL (aucun flux audio de lecture ou de capture n'est ouvert au niveau du HAL audio).

Créer et activer un effet d'appareil

Les effets audio spécifiques à l'appareil peuvent être instanciés à l'aide de l'une des deux méthodes ci-dessous.

Utiliser un fichier de configuration des effets audio

Cette méthode permet de créer de manière statique un effet audio qui est systématiquement associé et activé pour tout chemin audio sélectionnant un appareil spécifié comme récepteur ou source.

Pour ce faire, ajoutez une section spécifique dans le fichier audio_effects.xml comme suit : 

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

Utiliser une API système

Un nouveau constructeur @SystemApi a été ajouté à la android.media.audiofx.AudioEffect classe pour créer et activer un effet d'appareil : 

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

Une fois l'effet créé en spécifiant l'ID unique de l'effet audio et le descripteur de l'appareil audio, il peut être activé ou désactivé à l'aide des API AudioEffect existantes.

Une API est également disponible pour vérifier si une implémentation est compatible avec une combinaison appareil/effet donnée. 

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

Nouvelles API HAL

HAL d'effets audio

Le HAL d'effets audio V6.0 comporte une nouvelle signature pour la méthode createEffect() permettant de créer un effet associé à un appareil : 

IEffectFactory::createEffect(Uuid uid, AudioSession session,
AudioIoHandle ioHandle, AudioPortHandle device)
  • Le AudioSession spécifié doit être AudioSessionConsts.DEVICE.
  • AudioIoHandle est ignoré si la session est AudioSessionConsts.DEVICE.
  • Le device est identifié par son AudioPortHandle unique attribué par le framework audio lorsque l'appareil est sélectionné au niveau de le HAL audio avec IDevice::createAudioPatch() méthode.

HAL audio

Pour prendre en charge la fonctionnalité d'effet d'appareil, le HAL audio doit implémenter le contrôle du routage audio à l'aide de l'API IDevice::createAudioPatch(). Cela est indiqué par la méthode IDevice::supportsAudioPatches() qui renvoie true.

Deux nouvelles méthodes d'API, IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId) et IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId), indiquent à l'implémentation HAL qu'un effet d'appareil a été activé ou désactivé sur un appareil donné.

L'appareil est identifié par son ID AudioPortHandle, qui est utilisé lorsqu'un correctif audio est créé avec la méthode IDevice::createAudioPatch().

Les API HAL audio peuvent être utilisées par une implémentation si une coordination est nécessaire entre les HAL audio et d'effets lorsqu'un effet est activé ou désactivé.