HAL HIDL Audio

W Androidzie 13 i starszych interfejs Audio HAL jest definiowany za pomocą HIDL w plikach HAL HIDL (z rozszerzeniem .hal) i schematów XSD dla plików konfiguracji, jak pokazano poniżej.

Rysunek 1. Interfejs HAL dźwięku.

Pliki konfiguracji

Pliki konfiguracji XML zasad dotyczących dźwięku i efektów dźwiękowych są częścią interfejsu Audio HIDL HAL. Pliki te muszą być zgodne ze schematami, a zgodność jest weryfikowana przez testy VTS.

W ramach implementacji interfejsu HIDL HAL do obsługi dźwięku musisz utworzyć plik konfiguracji zasad dotyczących dźwięku, który opisuje topologię dźwięku. Aby framework mógł korzystać z możliwości HAL audio, muszą one zostać zadeklarowane w pliku audio_policy_configuration.xml.

API HAL HIDL dla dźwięku

W tej sekcji opisano interfejsy Core, Effects i Common HAL do obsługi HIDL.

Core HAL

Oto niektóre z głównych interfejsów Core HAL, które korzystają z HIDL:

• IDeviceFactory.hal to punkt wejścia do interfejsu API.
• IDevice.hal i IPrimaryDevice.hal zawierają takie metody jak setMasterVolume czy openInputStream.
• Strumienie są jednokierunkowe i służą do wysyłania lub odbierania dźwięku do HAL za pomocą interfejsów IStream.hal, IStreamOut.hal i IStreamIn.hal.

W tabeli poniżej znajdziesz przydatne komponenty Core HAL HIDL:

Domyślna implementacja interfejsu Core HAL API (/hardware/interfaces/audio/core/all-versions/default/) jest opakowaniem implementacji interfejsu HAL przed wprowadzeniem interfejsu Treble, która korzysta z starszych bibliotek współdzielonych. Domyślna implementacja może też służyć jako punkt odniesienia podczas wdrażania nowych wersji interfejsów Audio HAL, które bezpośrednio współpracują z sterownikami jądra.

Efekty HAL

Tabela poniżej zawiera listę przydatnych komponentów HAL efektów, które korzystają z HIDL:

Więcej informacji znajdziesz w przykładowej implementacji interfejsu Effects HAL API (/hardware/interfaces/audio/effect/all-versions/default/) oraz w sekcji Efekty dźwiękowe.

Wspólny HAL

Interfejs Common HAL API korzystający z HIDL zawiera:

• Definicje (/hardware/interfaces/audio/common/6.0/types.hal), które są wspólne dla interfejsów Core i Effect API.
• Narzędzia (/hardware/interfaces/audio/common/all-versions) ułatwiające kodowanie interfejsów HIDL API na potrzeby implementacji, klientów i testów.

Aktualizacje HAL dźwięku w wersji 7

W wersji 7 interfejsu Audio HAL w Androidzie 12 zaszły istotne zmiany, które opisano w tej sekcji. Interfejs Audio HAL V7:

• Ujednolica modele danych używane przez framework i HAL.
• Minimalizuje duplikowanie typów danych HIDL (enumeracji) i schematu XML używanego do konfiguracji zasad dotyczących dźwięku.

W Audio HAL V7 wprowadzono zmiany w tych obszarach:

• Typy zbiorów nazw
• Typy danych
• Tagi dostawcy
• Nazewnictwo rozszerzeń dostawców

Te zmiany są omawiane bardziej szczegółowo w odpowiednich sekcjach.

Wyliczenia

Począwszy od wersji Audio HAL 7 typy zagregowane używane w pliku konfiguracji zasad dotyczących dźwięku są definiowane tylko w schemacie XSD, a nie w HIDL.

W Audio HAL V6 wartości typów wyliczenia (takich jak AudioFormat) w types.hal są również zdefiniowane w schemacie XSD pliku konfiguracji zasad dotyczących dźwięku, co powoduje duplikację. Aby uniknąć tego w wersji 7, typy zbiorów zostały zmienione na string, a wszystkie możliwe wartości zbiorów są wymienione w schemacie XSD.

Na rysunku 2. porównano niektóre zmiany w typie zbioru AudioFormat w wersji 7:

Rysunek 2. Porównanie niektórych zmian w enumeracji AudioFormat.

Typy wyliczenia, które zostały przekonwertowane na string, znajdziesz na tej liście:

• AudioChannelMask
• AudioContentType
• AudioDevice: rozszerzalny przez dostawcę
• AudioFormat: rozszerzalny przez dostawcę
• AudioGainMode
• AudioSource
• AudioStreamType
• AudioUsage

Przekazywanie wartości typu wyliczeniowego ciągu znaków

Wartości ciągu znaków są używane do przesyłania informacji jako wartości zbioru na granicy interfejsu HAL. Zarówno platforma, jak i opakowanie HAL używają wartości typu całkowitego w enumeracji na potrzeby implementacji logiki biznesowej i stosują podejście do konwersji pokazane na rysunku 3:

Rysunek 3. Przekazywanie wartości typu wyliczeniowego ciągu znaków.

Aby na przykład przekazać wartość typu formatu audio z ramy do dostawcy:

1. Wartość enumeracji AudioFormat jest zamieniana na wartość ciągu znaków w libaudiohal i przekazywana do HAL.
2. Po stronie HAL domyślny wrapper konwertuje ciąg znaków na wartość enum, która jest przekazywana do starszej wersji HAL.

Zmiany schematu XML

Pełna lista wartości w definicji schematu XML (XSD) umożliwia lepszą walidację pliku XML konfiguracji zasad dotyczących dźwięku przez VTS. Wprowadziliśmy zmiany w pliku konfiguracji zasad dotyczących dźwięku używanym z HAL V7, aby był zgodny z XSD.

W wersji 7 do oddzielania list wartości w atrybutach (takich jak częstotliwości próbkowania, maski kanałów i flagi) zamiast symboli , (przecinek) i | (poprzeczna kreska) używa się standardowego znaku ␣ (spacja). Takie rozwiązanie jest stosowane w wersji 7 i nowszych. Jak widać w tym przykładzie, spacja służy do rozdzielania listy wartości w przypadku zmiennej channelMasks:

<profile channelMasks="AUDIO_CHANNEL_OUT_STEREO AUDIO_CHANNEL_OUT_MONO" … />

Aby wprowadzić zmiany symboli, użyj skryptu automatycznej konwersji o nazwie update_audio_policy_config.sh. Aby przekonwertować plik konfiguracji zasad dotyczących dźwięku w wersji V6 na plik w wersji V7 na urządzeniu Pixel 5 (Redfin), użyj tego polecenia:

hardware/interfaces/audio/7.0/config/update_audio_policy_config.sh \
device/google/redfin/audio/audio_policy_configuration.xml 6.0

Typy danych

W wersji 7 zdefiniowaliśmy ponownie niektóre struktury danych, aby zminimalizować liczbę definicji duplikatów. Powtarzające się tuple elementów danych są grupowane w struktury, które można ponownie wykorzystać. Te struktury danych korzystają z najnowszych funkcji HIDL, takich jak bezpieczne złączenia.

Na przykład w wersji 6 i starszych w interfejsach oraz typach HIDL często używana jest potrójka <format, sampling rate, channel mask>. Aby usunąć tę redundancję, w V7 typ danych AudioConfigBase i inne typy danych są zdefiniowane w ten sposób:

• AudioConfigBase := <format, sampling rate, channel mask>

• AudioConfigBaseOptional := <[fmt], [sampl. rate], [chan. mask]>

  używany przez AudioConfig, AudioOffloadInfo, AudioPortConfig

• AudioProfile := <format, {sampling rates}, {channel masks}>

  zastępuje luźne kolekcje w AudioPort/PortConfig

• AudioPortExtendedInfo := device | mix | session

  zastępuje związki w AudioPort/PortConfig

Tagi dostawcy

Oprócz typów i formatów urządzeń dostawcy mogą dodawać tagi niestandardowe do metadanych ścieżki audio.

W przypadku metadanych utworów do odtwarzania i nagrywania dostawcy mogą przekazywać własne tagi, które służą do dodawania atrybutów do strumieni wejść/wyjść audio z aplikacji do HAL.

Tagi dostawcy dla metadanych ścieżki odtwarzania są dodawane w ten sposób:

struct PlaybackTrackMetadata {
…
    /** Tags from AudioTrack audio attributes */
    vec<AudioTag> tags;
};

Struktura RecordTrackMetadata jest implementowana w podobny sposób poprzez dodanie tagów specyficznych dla metadanych utworu.

Nazewnictwo rozszerzeń dostawców

Od wersji HAL 7 rozszerzenia dostawcy wymagają dodatkowego prefiksu {vendor}, który nie jest wymagany w wersji 6. Aby prefiks {vendor} był prawidłowy, musi składać się z co najmniej 3 znaków alfanumerycznych.

W wersji 7 użyj tego formatu:

VX_{vendor}_{letters/numbers}

Oto kilka przykładów prawidłowych rozszerzeń dostawcy w wersji 7:

• VX_GOOGLE_VR
• VX_QCI_AMBIENT_MIC

Informacje o wersji

W tabeli poniżej podano numer wersji HAL dla każdej wersji Androida: