HAL Audio HIDL

Di Android 13 dan yang lebih lama, antarmuka Audio HAL ditentukan menggunakan HIDL dalam file HAL HIDL (dengan ekstensi .hal) dan skema XSD untuk file konfigurasi, yang ditampilkan sebagai berikut.

audio_hal

Gambar 1. Antarmuka HAL audio.

File konfigurasi

File konfigurasi XML kebijakan audio dan efek audio dianggap sebagai bagian dari antarmuka Audio HIDL HAL. File ini harus sesuai dengan skemanya, dan kesesuaian diverifikasi oleh pengujian VTS.

Sebagai bagian dari penerapan HAL HIDL audio, Anda harus membuat file konfigurasi kebijakan audio yang menjelaskan topologi audio. Kemampuan HAL audio harus dideklarasikan dalam file audio_policy_configuration.xml agar framework dapat menggunakannya.

Audio HIDL HAL API

Bagian ini menjelaskan API HAL Inti, Efek, dan Umum untuk HIDL.

HAL Inti

Beberapa antarmuka utama Core HAL, yang menggunakan HIDL, adalah sebagai berikut:

  • IDeviceFactory.hal adalah titik entri ke API.
  • IDevice.hal dan IPrimaryDevice.hal berisi metode seperti setMasterVolume atau openInputStream.
  • Streaming bersifat searah dan digunakan oleh AudioFlinger untuk mengirim atau menerima audio ke dan dari HAL melalui IStream.hal, IStreamOut.hal, dan IStreamIn.hal.

Tabel berikut mencantumkan lokasi komponen Core HAL HIDL yang berguna:

Komponen HAL inti Lokasi
Versi API terbaru /hardware/interfaces/audio/6.0
Jenis khusus untuk Core HAL API terbaru /hardware/interfaces/audio/6.0/types.hal
Skema XSD file konfigurasi kebijakan audio /hardware/interfaces/audio/6.0/config/audio_policy_configuration.xsd

Implementasi default Core HAL API (/hardware/interfaces/audio/core/all-versions/default/) adalah wrapper di sekitar implementasi HAL pra-Treble menggunakan library bersama lama. Implementasi default juga dapat dianggap sebagai referensi saat menerapkan versi baru Audio HAL yang berinteraksi dengan driver kernel secara langsung.

HAL Efek

Tabel berikut mencantumkan lokasi komponen HAL Efek yang berguna menggunakan HIDL:

Komponen HAL efek Lokasi
Versi API terbaru /hardware/interfaces/audio/effect/6.0/
Skema XSD file konfigurasi efek /hardware/interfaces/audio/effect/6.0/xml/audio_effects_conf.xsd

Untuk informasi selengkapnya, lihat contoh implementasi Effects HAL API di /hardware/interfaces/audio/effect/all-versions/default/ dan bagian Audio Effects.

HAL Umum

Common HAL API yang menggunakan HIDL berisi hal berikut:

  • Definisi (/hardware/interfaces/audio/common/6.0/types.hal) yang dibagikan oleh Core dan Effect API.
  • Utilitas (/hardware/interfaces/audio/common/all-versions) yang digunakan untuk membantu coding terhadap HIDL API untuk implementasi, klien, dan pengujian.

Update pada Audio HAL V7

Ada perubahan signifikan pada HAL Audio versi 7 di Android 12 seperti yang diuraikan di bagian ini. Audio HAL V7 melakukan hal berikut:

  • Menggabungkan model data yang digunakan oleh framework dan HAL.
  • Meminimalkan duplikasi antara jenis data HIDL (enum) dan skema XML yang digunakan untuk konfigurasi kebijakan audio.

Secara khusus, perubahan dilakukan di area berikut di Audio HAL V7:

Perubahan ini dibahas lebih mendetail di bagian masing-masing.

Enumerasi

Mulai dari Audio HAL V7, jenis yang dihitung yang digunakan dalam file Konfigurasi Kebijakan Audio hanya ditentukan dalam skema XSD, bukan dalam HIDL.

Di Audio HAL V6, nilai jenis enum (seperti AudioFormat) di types.hal juga ditentukan dalam skema XSD file konfigurasi kebijakan audio, sehingga membuat duplikasi. Untuk menghindari hal ini di V7, jenis enum diubah menjadi string dan semua kemungkinan nilai enumerasi dicantumkan dalam skema XSD.

Gambar 2 membandingkan beberapa perubahan pada jenis enum AudioFormat di V7:

audioformat-change

Gambar 2. Perbandingan beberapa perubahan pada enum AudioFormat.

Lihat daftar berikut untuk jenis enum yang telah dikonversi ke string:

  • AudioChannelMask
  • AudioContentType
  • AudioDevice: Dapat diperluas oleh vendor
  • AudioFormat: Dapat diperluas oleh vendor
  • AudioGainMode
  • AudioSource
  • AudioStreamType
  • AudioUsage

Meneruskan nilai enum string

Nilai string digunakan untuk mentransfer informasi sebagai nilai enumerasi di seluruh batas antarmuka HAL. Framework dan wrapper HAL menggunakan nilai enum bilangan bulat untuk menerapkan logika bisnis dan menggunakan pendekatan konversi yang digambarkan dalam Gambar 3:

audio-passing-values

Gambar 3. Meneruskan nilai enum string.

Sebagai contoh, untuk meneruskan nilai jenis format audio dari framework ke vendor:

  1. Nilai enum AudioFormat dikonversi menjadi nilai string di libaudiohal dan diteruskan ke HAL.
  2. Di sisi HAL, wrapper default mengonversi string menjadi nilai enum, yang diteruskan ke HAL lama.

Perubahan skema XML

Memiliki daftar lengkap nilai enum dalam definisi skema XML (XSD) memungkinkan validasi file XML konfigurasi kebijakan audio yang lebih baik oleh VTS. Kami membuat perubahan pada file konfigurasi kebijakan audio yang digunakan dengan HAL V7 agar sesuai dengan XSD.

Di V7, karakter ␣ (spasi) standar digunakan untuk membatasi daftar nilai dalam atribut (seperti kecepatan sampling, mask saluran, dan tanda), bukan simbol , (koma) dan | (garis vertikal) yang digunakan di V6 dan yang lebih lama. Seperti yang terlihat dalam contoh berikut, spasi digunakan untuk membatasi daftar nilai untuk channelMasks:

<profile channelMasks="AUDIO_CHANNEL_OUT_STEREO AUDIO_CHANNEL_OUT_MONO" … />

Untuk membuat perubahan simbol, gunakan skrip konversi otomatis yang disebut update_audio_policy_config.sh. Lihat perintah berikut untuk mengonversi file konfigurasi kebijakan audio V6 ke versi V7 untuk perangkat Pixel 5 (Redfin):

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

Jenis data

Kami mendefinisikan ulang beberapa struktur data di V7 untuk meminimalkan definisi duplikat. Tupel item data berulang dikelompokkan menjadi struktur yang dapat digunakan kembali. Struktur data ini menggunakan fitur HIDL terbaru seperti gabungan aman.

Misalnya, di V6 dan yang lebih lama, tiga <format, sampling rate, channel mask> sering digunakan dalam antarmuka dan jenis HIDL. Untuk menghapus redundansi ini, di V7, jenis data AudioConfigBase dan jenis data lainnya ditentukan sebagai berikut:

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

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

    digunakan oleh AudioConfig, AudioOffloadInfo, AudioPortConfig

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

    menggantikan koleksi longgar di AudioPort/PortConfig

  • AudioPortExtendedInfo := device | mix | session

    mengganti gabungan di AudioPort/PortConfig

Tag vendor

Selain jenis dan format perangkat, vendor dapat menambahkan tag kustom untuk metadata jalur audio.

Untuk metadata trek pemutaran dan perekaman, vendor dapat meneruskan tag mereka sendiri, yang digunakan untuk menambahkan atribut ke streaming I/O audio, dari aplikasi ke HAL.

Tag vendor untuk metadata trek pemutaran ditambahkan seperti yang terlihat dalam contoh berikut:

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

Struktur RecordTrackMetadata diimplementasikan dengan cara yang serupa dengan menambahkan tag khusus untuk metadata trek rekaman.

Namespace ekstensi vendor

Mulai HAL V7, ekstensi vendor memerlukan awalan {vendor} tambahan yang tidak diperlukan di V6. Agar valid, awalan {vendor} harus terdiri dari tiga karakter alfanumerik atau lebih.

Gunakan format berikut di V7:

VX_{vendor}_{letters/numbers}

Berikut adalah beberapa contoh ekstensi vendor V7 yang valid:

  • VX_GOOGLE_VR
  • VX_QCI_AMBIENT_MIC

Informasi versi

Tabel berikut mencantumkan nomor versi HAL untuk setiap rilis Android:

Versi Android Versi HAL HIDL
Android 13 7.1
Android 12 7,0
Android 11 6.0
Android 10 5,0
Android 9 4.0
Android 8 2.0