オーディオ効果

Android 11 以降では、デバイスメーカーは、特定のオーディオデバイスが音声キャプチャまたは再生用に選択されている場合、特定のオーディオエフェクトを自動的にアタッチして有効にできます。主な改善点としては、オーディオ HAL の下に完全に実装されたオーディオパス（入力デバイスと出力デバイスの間の直接接続）に挿入されたオーディオエフェクトを、オーディオエフェクトフレームワークで制御できることが挙げられます。

この機能は主に自動車 OEM を対象としていますが、他の Android フォームファクタでも使用できます。サンプルアプリは、オーディオ DSP を介してスピーカーに直接接続されたとき、FM チューナー出力に音声強調エフェクトを挿入します。

前提条件

その他のオーディオエフェクトについては、ベンダーライブラリによって実装し、audio_effects.xml 構成ファイルにリストする必要があります。
エフェクトのタイプは、前処理または後処理（EffectDescriptor.flags でフラグ TYPE_PRE_PROC または TYPE_POST_PROC を設定）である必要があります。
エフェクトの実装が HW アクセラレーション（EffectDescriptor.flags でフラグ HW_ACC_TUNNEL を設定）の場合、HAL の下で完全に接続されたオーディオパスにアタッチできます（再生またはキャプチャオーディオストリームをオーディオ HAL で開かない）。

デバイスエフェクトの作成と有効化

デバイス固有のオーディオエフェクトは、次の 2 つの方法のいずれかを使用してインスタンス化できます。

オーディオエフェクト構成ファイルを使用する

この方法では、シンクまたはソースとして指定したデバイスを選択して、任意のオーディオパスに体系的にアタッチして有効にするオーディオエフェクトを静的に作成できます。

そのためには、次のように audio_effects.xml ファイルに特定のセクションを追加します。

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

システム API を使用する

デバイスエフェクトを作成して有効にするための新しい @SystemApi コンストラクタが、android.media.audiofx.AudioEffect クラスに追加されました。

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

一意のオーディオエフェクト ID とオーディオデバイス記述子を指定してエフェクトを作成した後、既存の AudioEffect API を使用してエフェクトを有効または無効にできます。

API を使用して、特定のデバイスとエフェクトの組み合わせを実装がサポートしいるかどうかを照会することもできます。

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

新しい HAL API

オーディオエフェクト HAL

オーディオエフェクト HAL V6.0 には createEffect() メソッドの新しい署名が追加されており、デバイスにアタッチされるエフェクトを作成できます。

IEffectFactory::createEffect(Uuid uid, AudioSession session,
AudioIoHandle ioHandle, AudioPortHandle device)

指定する AudioSession は AudioSessionConsts.DEVICE である必要があります。
session が AudioSessionConsts.DEVICE の場合、AudioIoHandle は無視されます。
device は、IDevice::createAudioPatch() メソッドを使用してオーディオ HAL でデバイスが選択されたとき、オーディオフレームワークによって割り当てられる一意の AudioPortHandle によって識別されます。

オーディオ HAL

デバイスエフェクト機能をサポートするには、オーディオ HAL で IDevice::createAudioPatch() API を使用して、オーディオルーティングコントロールを実装する必要があります。これは、true をレポートする IDevice::supportsAudioPatches() メソッドによって示されます。

IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId) と IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId) という 2 つの新しい API メソッドは、特定のデバイスに対しデバイスエフェクトが有効または無効にされたことを HAL 実装に伝えます。

デバイスは、IDevice::createAudioPatch() メソッドでオーディオパッチを作成するときに使用される AudioPortHandle ID によって識別されます。

オーディオ HAL API は、エフェクトを有効または無効にする際、オーディオ HAL とエフェクト HAL の間で調整が必要な場合に実装で使用できます。