Efekty dźwiękowe

Od Androida 11 producenci urządzeń mają możliwość aby automatycznie dołączać i włączać określone efekty dźwiękowe, gdy dane urządzenie audio jest wybrany do przechwytywania lub odtwarzania dźwięku. Istotną poprawą jest to, że wstawiane efekty dźwiękowe na ścieżce audio w całości zaimplementowanej poniżej audio HAL (bezpośrednie połączenie między wejściem urządzenia i urządzenia wyjściowego) można sterować za pomocą platformy efektów audio.

Ta funkcja jest przeznaczona głównie dla firm motoryzacyjnych OEM, ale może być używana również na urządzeniach z Androidem i formatów. Przykładowa aplikacja dodaje efekt ulepszenia głosu w tunerze FM bezpośrednio z głośnika przez procesor DSP audio.

Wymagania wstępne

  • Tak jak w przypadku innych efektów dźwiękowych, efekt musi być zaimplementowany przez bibliotekę dostawcy i być w pliku konfiguracji audio_effects.xml.
  • Efekt musi być typu wstępnego lub końcowego przetwarzania (flaga TYPE_PRE_PROC lub TYPE_POST_PROC ustawiony w funkcji EffectDescriptor.flags).
  • Jeśli implementacja efektu jest przyspieszone (flaga HW_ACC_TUNNEL ustawiona w EffectDescriptor.flags), można go dołączyć do ścieżki audio w pełni połączonej poniżej HAL (bez odtwarzania lub przechwyć strumień audio otwarty dla HAL audio).

Utwórz i włącz efekt urządzenia

Wystąpienia efektów dźwiękowych specyficznych dla urządzenia można utworzyć za pomocą jednej z 2 poniższych metod.

Użyj pliku konfiguracji efektów dźwiękowych

Ta metoda pozwala na statyczne tworzenie efektu audio, który jest systematycznie dołączany i włączony w dowolnej ścieżce audio, wybierając określone urządzenie jako ujście lub źródło.

Aby to zrobić, dodaj określoną sekcję w audio_effects.xml w następujący sposób:

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

Użyj systemowego interfejsu API

Do interfejsu API został dodany nowy konstruktor @SystemApi android.media.audiofx.AudioEffect, aby utworzyć i włączyć efekt urządzenia:

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

Gdy utworzysz efekt przez określenie unikalnego identyfikatora efektu audio i deskryptora urządzenia audio, Można go włączyć lub wyłączyć za pomocą istniejących interfejsów API AudioEffect.

Dostępny jest też interfejs API do wysyłania zapytań, aby sprawdzić, czy implementacja obsługuje określoną kombinację urządzenia i efektu.

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

Nowe interfejsy API HAL

HAL efektu audio

Efekt audio HAL w wersji 6.0 ma nowy podpis dla metody createEffect() umożliwia tworzenie efektu podłączonego do urządzenia:

IEffectFactory::createEffect(Uuid uid, AudioSession session,
AudioIoHandle ioHandle, AudioPortHandle device)
  • AudioSession musi być wartością AudioSessionConsts.DEVICE.
  • Wartość AudioIoHandle jest ignorowana, jeśli pole session ma wartość AudioSessionConsts.DEVICE
  • Element device jest identyfikowany przez unikalny element AudioPortHandle przypisany przez platformę audio po wybraniu urządzenia dźwięku HAL z metodą IDevice::createAudioPatch().

HAL audio

Aby można było obsługiwać funkcję efektów urządzenia, interfejs audio HAL musi obsługiwać kierowanie dźwięku. za pomocą interfejsu API IDevice::createAudioPatch(). Jest to wskazywane przez tag Raportowanie metod IDevice::supportsAudioPatches() true.

Dwie nowe metody interfejsu API: IDevice::addDeviceEffect(AudioPortHandle device, uint64_t effectId) i IDevice::removeDeviceEffect(AudioPortHandle device, uint64_t effectId) poinformować implementację HAL, że efekt urządzenia został włączony lub wyłączony. danego urządzenia.

Urządzenie jest identyfikowane za pomocą identyfikatora AudioPortHandle, który jest używany, gdy dźwięk poprawka jest tworzona za pomocą metody IDevice::createAudioPatch().

Interfejsy Audio HAL API mogą być używane w implementacji, jeśli potrzebna jest koordynacja między dźwięku i efektów HAL, gdy efekt jest włączony lub wyłączony.