Perutean perangkat audio gabungan

Fitur pemilihan rute perangkat audio gabungan menambahkan dukungan untuk streaming audio ke beberapa perangkat audio secara bersamaan. Dengan fitur ini, aplikasi dengan hak istimewa dapat memilih beberapa perangkat pilihan untuk strategi tertentu melalui API sistem. Aplikasi dapat menemukan kemampuan perangkat audio dengan lebih teliti menggunakan API publik yang disediakan oleh fitur ini. Untuk Android versi 11 dan yang lebih lama, implementasi framework audio memiliki dukungan terbatas untuk beberapa perangkat audio dari jenis yang sama (misalnya, 2 headset A2DP Bluetooth) yang terhubung secara bersamaan. Aturan pemilihan rute audio default juga tidak mengizinkan pengguna memilih beberapa perangkat dari jenis yang sama untuk kasus penggunaan tertentu.

Mulai Android 12, batasan ini dihapus untuk memungkinkan kasus penggunaan baru seperti siaran audio, multicast ke grup headset audio BLE, atau memilih beberapa kartu suara USB secara bersamaan. Pemilihan rute ke beberapa perangkat USB secara bersamaan tidak didukung.

Mulai Android 14, framework USB mendukung rute ke beberapa perangkat USB asalkan perangkat USB memiliki jenis perangkat audio yang berbeda dan, ada dukungan kernel dan vendor untuk menghubungkan beberapa perangkat USB secara bersamaan.

Halaman ini membahas cara menerapkan dukungan untuk streaming audio ke beberapa perangkat audio, dan cara memvalidasi penerapan fitur ini.

Catatan: Implementasi fitur ini sepenuhnya di AOSP. Beberapa pengujian berada di GTS, yang tidak ada di AOSP.

Mendukung streaming audio ke beberapa perangkat audio

Ada dua kumpulan API di Android 12 yang mendukung fitur ini:

• API sistem menangani beberapa perangkat pilihan untuk strategi.
• Antarmuka HIDL, yang diimplementasikan oleh vendor sebagai bagian dari HAL audio, melaporkan kemampuan perangkat.

Bagian berikut membahas setiap API ini secara lebih mendetail.

Menangani beberapa perangkat pilihan untuk strategi

Pengelola Kebijakan Audio menawarkan API sistem untuk lebih mendukung streaming audio ke beberapa perangkat audio secara bersamaan. API sistem ini memungkinkan setelan, mendapatkan, dan menghapus beberapa perangkat pilihan untuk strategi tertentu. Hingga Android 12, fitur ini hanya didukung untuk satu perangkat.

Pengelola Kebijakan Audio memperkenalkan konsep perangkat media aktif untuk menjelaskan perangkat yang paling mungkin dipilih untuk pemutaran media. Saat perangkat dilepas terhubung, streaming output HAL audio yang dapat dirutekan ke perangkat ini mungkin harus dibuka dan diperiksa untuk atribut yang didukung.

Catatan: Jika ada profil audio dinamis yang didukung dan tidak semua jalur aktif diarahkan ulang, aliran data output tidak segera dibuka kembali saat perangkat terhubung, tetapi beberapa saat kemudian saat semua jalur tidak aktif.

Perangkat audio harus ditentukan saat membuka streaming output. Perangkat media aktif adalah perangkat yang digunakan saat streaming output dibuka dalam konteks ini.

Pilihan perangkat media yang aktif dapat berubah bergantung pada perangkat sebenarnya yang terhubung atau terputus. Pengelola Kebijakan Audio menggunakan serangkaian aturan berikut untuk memilih perangkat media aktif:

1. Jika semua perangkat pilihan untuk media tersedia, semua perangkat tersebut akan dipilih sebagai perangkat aktif.
2. Jika tidak, perangkat yang dapat dilepas yang terakhir terhubung akan dipilih.
3. Jika tidak ada perangkat yang dapat dilepas yang terhubung, aturan kebijakan audio default untuk memilih perangkat output akan diterapkan untuk memilih perangkat aktif.

Streaming output harus memenuhi kriteria berikut agar dapat dibuka kembali dan dirutekan ke perangkat aktif sehingga konfigurasi terbaik dipilih untuk pemutaran:

• Streaming output harus mendukung perangkat yang aktif.
• Streaming output harus mendukung profil dinamis.
• Streaming output saat ini tidak boleh dirutekan ke perangkat aktif.

Untuk menerapkan pemilihan perangkat baru, Pengelola Kebijakan Audio akan menutup dan membuka kembali aliran output setelah koneksi perangkat jika aliran output tidak ada aktivitas, atau menundanya saat aliran output ditempatkan ke mode standby.

Audio Policy Manager menawarkan daftar API sistem berikut(seperti yang ditentukan dalam AudioManager.java):

• setPreferredDeviceForStrategy

  Menetapkan perangkat pilihan untuk pemilihan rute audio untuk strategi tertentu. Perhatikan bahwa perangkat mungkin tidak tersedia pada saat perangkat pilihan ditetapkan, tetapi akan digunakan setelah tersedia.

• removePreferredDeviceForStrategy

  Menghapus perangkat audio pilihan yang sebelumnya disetel dengan setPreferredDeviceForStrategy atau setPreferredDevicesForStrategy.

• getPreferredDeviceForStrategy

  Menampilkan perangkat pilihan untuk strategi audio yang sebelumnya ditetapkan dengan setPreferredDeviceForStrategy atau setPreferredDevicesForStrategy.

• setPreferredDevicesForStrategy

  Menetapkan perangkat pilihan untuk strategi tertentu.

• getPreferredDevicesForStrategy

  Menampilkan perangkat pilihan untuk strategi audio yang sebelumnya ditetapkan dengan setPreferredDeviceForStrategy atau setPreferredDevicesForStrategy.

• OnPreferredDevicesForStrategyChangedListener

  Menentukan antarmuka untuk notifikasi perubahan pada perangkat audio pilihan yang ditetapkan untuk strategi audio tertentu.

• addOnPreferredDevicesForStrategyChangedListener

  Menambahkan pemroses untuk mendapatkan notifikasi tentang perubahan pada perangkat audio yang disukai strategi.

• removeOnPreferredDevicesForStrategyChangedListener

  Menghapus pemroses perubahan yang ditambahkan sebelumnya pada perangkat audio pilihan strategi.

Melaporkan kemampuan perangkat

Sebagai bagian dari penerapan Audio HAL, vendor menerapkan API yang mendukung kemampuan pelaporan perangkat. Bagian ini menjelaskan jenis dan metode data yang digunakan untuk melaporkan kemampuan perangkat dan mencantumkan beberapa perubahan yang dilakukan di audio HIDL HAL V7 untuk mendukung beberapa perangkat.

Jenis data

Dalam audio HIDL HAL V7, kemampuan perangkat dilaporkan menggunakan struktur AudioProfile dan AudioTransport. Struktur AudioTransport menjelaskan kemampuan port audio dengan AudioProfile untuk format audio yang diketahui, atau dengan deskripsi hardware mentah untuk format yang tidak diketahui oleh platform. Struktur AudioProfile berisi format audio, frekuensi sampel yang didukung oleh profil, dan daftar mask saluran, seperti yang ditunjukkan dalam blok kode berikut dari types.hal:

/**
* Configurations supported for a certain audio format.
*/
struct AudioProfile {
   AudioFormat format;
   /** List of the sample rates (in Hz) supported by the profile. */
   vec<uint32_t> sampleRates;
   /** List of channel masks supported by the profile. */
   vec<AudioChannelMask> channelMasks;
};

Di audio HIDL HAL V7, jenis data AudioPort ditentukan dengan struktur AudioTransport danAudioProfile untuk mendeskripsikan kemampuan perangkat.

Catatan: Sebelum Android 12, struktur AudioDeviceInfo SDK API menjelaskan kemampuan audio seperti frekuensi sampel, format, dan mask saluran dalam format array yang diratakan, yang tidak memiliki hubungan yang jelas antara format dan frekuensi sampel serta mask saluran. AudioProfile, seperti yang ditentukan di atas, telah menggantikannya mulai Android 12.

Metode HAL Audio

Pengelola Kebijakan Audio menggunakan metode berikut untuk membuat kueri kemampuan perangkat:

• getParameters:Metode umum untuk mengambil nilai parameter khusus vendor seperti format audio yang didukung dan kecepatan samplingnya masing-masing.
• getAudioPort:Menampilkan daftar atribut yang didukung (seperti frekuensi pengambilan sampel, format, mask saluran, pengontrol keuntungan) untuk port audio tertentu.

Kode berikut dari IDevice.hal menunjukkan antarmuka untuk metode getAudioPort:

   /**
    * Returns the list of supported attributes for a given audio port.
    *
    * As input, 'port' contains the information (type, role, address etc...)
    * needed by the HAL to identify the port.
    *
    * As output, 'resultPort' contains possible attributes (sampling rates,
    * formats, channel masks, gain controllers...) for this port.
    *
    * @param port port identifier.
    * @return retval operation completion status.
    * @return resultPort port descriptor with all parameters filled up.
    */
   getAudioPort(AudioPort port)
           generates (Result retval, AudioPort resultPort);

Perubahan pada API lama

Untuk mendukung beberapa profil audio, API lama versi 3.2 menambahkan struktur baru yang disebut audio_port_v7. Lihat kode sumber untuk mengetahui detail selengkapnya.

Karena penambahan audio_port_v7, API lama versi 3.2 menambahkan API baru yang disebut get_audio_port_v7 untuk membuat kueri kemampuan perangkat menggunakan struktur audio_port_v7.

Kode berikut dari audio.h menunjukkan definisi get_audio_port_v7 API:

/**
 * Fills the list of supported attributes for a given audio port.
 * As input, "port" contains the information (type, role, address etc...)
 * needed by the HAL to identify the port.
 * As output, "port" contains possible attributes (sampling rates,
 * formats, channel masks, gain controllers...) for this port. The
 * possible attributes are saved as audio profiles, which contains audio
 * format and the supported sampling rates and channel masks.
 */
 int (*get_audio_port_v7)(struct audio_hw_device *dev,
                          struct audio_port_v7 *port);

Catatan: getAudioPort memanggil get_audio_port_v7 API hanya jika audio versi HIDL HAL adalah 7 atau yang lebih baru dan API versi lama adalah 3.2 atau yang lebih baru. Untuk HAL HIDL audio versi 6 dan yang lebih lama atau versi API lama di bawah 3.2, getAudioPort akan memanggil get_audio_port API untuk mengkueri kemampuan perangkat.

Data dari get_audio_port API lama harus diisi ke dalam format AudioPort baru saat versi API lama di bawah 3.2 dan versi HIDL HAL adalah 7 atau yang lebih baru. Dalam hal ini, semua frekuensi sampel dan mask saluran yang dilaporkan dari get_audio_port diasumsikan didukung untuk semua format yang ditampilkan, sehingga memungkinkan pemetaan langsung dari nilai get_audio_port ke struktur AudioPort baru.

Contoh penerapan API

Bagian ini menjelaskan beberapa rangkaian pengujian yang berisi metode yang menggunakan API yang dibahas di bagian sebelumnya. Lihat metode ini untuk beberapa contoh cara API ini diterapkan dan digunakan.

Contoh penggunaan API sistem setPreferredDevicesForStrategy, getPreferredDevicesForStrategy, removePreferredDeviceForStrategy, dan OnPreferredDevicesForStrategyChangedListener ada dalam metode PreferredDeviceRoutingTest, yang terletak di GTS.

Untuk melihat contoh struktur baru di AudioDeviceInfo yang digunakan, lihat metode AudioManagerTest#testGetDevices yang terletak di CTS.

Catatan: Kode CTS untuk implementasi ini akan dipublikasikan dengan rilis Android 12.

Contoh implementasi untuk get_audio_port_v7 terletak di audio_hal.c dan menunjukkan cara kemampuan dikueri untuk beberapa perangkat.

Validasi

Bagian ini memberikan informasi tentang validasi CTS dan GTS (Google Mobile Services Test Suite) untuk Pengelola Audio.

Catatan: GTS adalah sumber tertutup dan memiliki pengujian yang lebih lengkap untuk API perangkat pilihan daripada CTS. Untuk cakupan pengujian tambahan, jalankan juga pengujian CTS.

Pengujian CTS

Uji CTS terletak di android.media.cts.AudioManagerTest.

Berikut adalah daftar pengujian Pengelola Audio yang tersedia:

• AudioManagerTest#testGetDevices

  Memverifikasi kemampuan perangkat audio yang tepat. Tindakan ini juga memverifikasi bahwa profil audio yang ditampilkan dalam struktur AudioDeviceInfo mempertahankan konten dari format array lama yang diratakan, tetapi menggunakan format AudioProfile baru.

  Catatan: Array AudioProfile yang ditampilkan dari panggilan ke AudioDeviceInfo#getAudioProfiles() harus berisi konten yang sama dengan array yang diratakan dari panggilan ke AudioDeviceInfo#getEncodings(), AudioDeviceInfo#getSampleRates(), dan AudioDeviceInfo#getChannelMasks().

• AudioManagerTest#testPreferredDevicesForStrategy dan AudioManagerTest#testPreferredDeviceForCapturePreset

  Pastikan perangkat pilihan untuk strategi dan pengambilan pengujian API terkait preset berhasil diselesaikan.

Pengujian GTS

Pengujian GTS berada di com.google.android.gts.audioservice.AudioServiceHostTest.

Untuk memvalidasi apakah API untuk perangkat pilihan untuk strategi dan pengambilan preset berfungsi dengan benar, jalankan pengujian AudioServiceHostTest#testPreferredDeviceRouting dan AudioServiceHostTest#testPreferredDeviceRoutingForCapturePreset.