Atribut mixer pilihan di perangkat USB

Android 14 menyediakan API developer yang dapat digunakan aplikasi untuk membuat kueri dan mengonfigurasi atribut mixer pilihan untuk pemutaran audio USB. Atribut mixer pilihan ini meningkatkan pengalaman pemutaran audio USB dengan memungkinkan aplikasi menetapkan format audio, mask saluran, frekuensi sampel, dan perilaku mixer. Dengan menggunakan API mixer pilihan di perangkat USB yang didukung, pengguna dapat memperoleh pemutaran audio dengan latensi lebih rendah dan konten audio beresolusi lebih tinggi.

Fitur ini juga memberikan dukungan untuk perilaku mixer pemutaran bit-perfect opsional untuk perangkat USB. Mode bit-perfect memungkinkan pemutaran untuk format master quality authenticated (MQA) dan direct stream digital (DSD) pada digital to analog converter (DAC) yang kompatibel.

Antarmuka

Audio Policy Manager menangani atribut mixer dalam framework. Class AudioMixerAttributes mewakili atribut mixer. Class AudioMixerAttributes mencakup objek AudioFormat yang menjelaskan format data audio, mask saluran, dan frekuensi sampel untuk mixer. Secara default, framework menentukan perilaku mixer, yang mencampur semua sumber audio dan menerapkan kontrol volume serta efek.

Jika perilaku mixer menggunakan mode BIT_PERFECT, sistem akan mengirimkan konten audio tanpa modifikasi melalui framework audio, HAL, dan secara opsional digital signal processor (DSP), dari API hingga ke perangkat USB. Mode BIT_PERFECT mendukung format yang dienkode, seperti MQA atau DSD, yang penskalaan atau pencampuran volume apa pun dapat merusak arti data.

Saat aplikasi mengonfigurasi atribut mixer, framework akan membuka kembali aliran output dengan atribut baru, jika diperlukan. Gambar berikut menunjukkan antarmuka antara aplikasi, framework, dan HAL saat atribut mixer ditetapkan:

Gambar 1. Antarmuka antara aplikasi, framework, dan HAL.

Penerapan

Penerapan atribut mixer pilihan, selain atribut BIT_PERFECT, untuk audio USB wajib dilakukan untuk Android 14.

Atribut mixer pilihan

Untuk mendukung atribut mixer pilihan, vendor harus mendukung perutean perangkat USB ke port campuran dinamis, sebagai berikut:

1. Tentukan port campuran dinamis di usb_audio_policy_configuration.xml.

2. Deklarasikan kemampuan untuk merutekan perangkat USB ke port campuran dinamis baik dalam konfigurasi kebijakan audio maupun dalam metode AIDL getAudioPorts dan getAudioRoutes.

Lihat implementasi referensi untuk HAL audio USB di bagian hardware/libhardware/modules/usbaudio. Lihat contoh port campuran dinamis di frameworks/av/services/audiopolicy/config/usb_audio_policy_configuration.xml.

Atribut pemutaran bit-perfect

Atribut pemutaran bit-perfect bersifat opsional dan hanya didukung dalam implementasi AIDL Audio HAL. Untuk mendukung pemutaran bit-perfect, vendor harus menambahkan flag output bit-perfect AUDIO_OUTPUT_FLAG_BIT_PERFECT ke port campuran dinamis yang dapat dirutekan ke perangkat USB.

Contoh kode berikut menunjukkan penggunaan flag AUDIO_OUTPUT_FLAG_BIT_PERFECT di usb_audio_policy_configuration.xml:

<module name="usb" halVersion="2.0">
    <mixPorts>
        <mixPort name="hifi_output"
                 role="source" flags="AUDIO_OUTPUT_FLAG_BIT_PERFECT">
        </mixPort>
    </mixPorts>
    <devicePorts>
        <devicePort tagName="USB Device Out"
                    type="AUDIO_DEVICE_OUT_USB_DEVICE" role="sink">
        </devicePort>
    </devicePorts>
    <routes>
        <route type="mix" sink="USB Device Out"
               sources="hifi_output"/>
    </routes>
</module>

Jika atribut pemutaran bit-perfect ditentukan, HAL harus memastikan bahwa aliran audio dikirim ke perangkat USB tanpa modifikasi apa pun, yaitu aliran audio tidak boleh memiliki penskalaan volume, konversi frekuensi sampel, atau efek pemrosesan audio apa pun dan tidak boleh dicampur di DSP. Dalam hal ini, hardware mengontrol volume karena framework tidak menyediakan kontrol volume software apa pun.

Validasi

Jalankan pengujian CTS di PreferredMixerAttributesTestActivity.java untuk memvalidasi dukungan untuk atribut mixer pilihan untuk perangkat USB.

Untuk memvalidasi penerapan atribut BIT_PERFECT, gunakan DAC USB yang mendukung MQA dan DSD melalui format audio pulse-code modulation (PCM).