Menghubungkan perangkat input di AAOS

Anda dapat menggunakan mekanisme ini untuk memutar audio di Android:

Setiap mekanisme memungkinkan pemutaran audio dilakukan di Android. Untuk pemutaran radio atau pemutaran dari perangkat input, opsi ini mungkin tidak cukup, meskipun setiap opsi dapat digabungkan dengan pengambilan audio atau class MediaRecorder untuk mengambil audio terlebih dahulu, lalu memutarnya kembali dari Android. Khusus untuk aplikasi sistem, informasi berikut dapat digunakan untuk menghubungkan perangkat input ke mixer output di AAOS.

Pemutar HwAudioSource

HwAudioSource menghubungkan perangkat sumber audio langsung ke mixer Android.

Motivasi

Beberapa batasan dapat muncul saat menggunakan patch audio hardware atau perangkat ke perangkat dengan Android. Setiap opsi tidak dapat menerima peristiwa tombol media seperti PLAY, PAUSE, dan STOP dan, karena opsi tersebut menghindari stack audio Android, setiap opsi memerlukan hardware untuk mencampur patch ke audio lain dari Android.

Menggunakan HwAudioSource

HwAudioSource adalah jenis pemain baru yang didesain sebagai patch software. Hal ini memungkinkan aplikasi yang menggunakan pemutar ini menerima peristiwa tombol media dan output stream untuk dicampur dan dirutekan oleh Android.

mHwAudioSource = new HwAudioSource.Builder()
                .setAudioDeviceInfo(AudioDeviceInfo: info)
                .setAudioAttributes(new AudioAttributes.Builder()
                        .setUsage(AudioAttributes.USAGE_MEDIA)
                        .build())
                .build();
mHwAudioSource.play();
mHwAudioSource.stop();

Perubahan pada HAL audio

Dengan pemutar baru ini, pertimbangkan ekspektasi berikut untuk HAL audio. Misalnya, device/generic/car/emulator/audio/driver/audio_hw.c.

  • adev_create_audio_patch mengharapkan permintaan untuk membuat patch audio dari perangkat ke mixer.

  • adev_open_input_stream mengharapkan audio_source menjadi AUDIO_SOURCE_FM_TUNER.

  • in_read mengisi buffer audio dengan data audio radio siaran.

Sebaiknya Anda mengonfigurasi perangkat tuner dengan jenis AUDIO_DEVICE_IN_FM_TUNER di audio_policy_configuration.xml:

<devicePort
    tagName="Tuner_source"
    type="AUDIO_DEVICE_IN_FM_TUNER"
    role="source"
    address="tuner0">
    <profile
        name=""
        format="AUDIO_FORMAT_PCM_16_BIT"
        samplingRates="48000"
        channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
</devicePort>

Dengan konfigurasi perangkat ini, Anda dapat mempermudah penemuan perangkat input radio FM menggunakan AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTS bersama dengan AudioDeviceInfo.TYPE_FM_TUNER.

Membuat patch audio

Anda dapat membuat patch audio antara dua port audio, baik port campuran atau port perangkat. Biasanya, patch audio dari port campuran ke port perangkat adalah untuk pemutaran, sedangkan arah sebaliknya adalah untuk perekaman.

Misalnya, patch audio yang merutekan sampel audio dari sumber FM_TUNER secara langsung ke sink media akan melewati mixer software. Kemudian, Anda harus menggunakan mixer hardware untuk mencampur sampel audio dari Android dan FM_TUNER untuk sink. Saat membuat patch audio langsung dari sumber FM_TUNER ke media sink:

  • Kontrol volume berlaku untuk sink media dan akan memengaruhi audio Android dan FM_TUNER.

  • Pengguna dapat beralih antara audio Android dan FM_TUNER melalui peralihan aplikasi sederhana (tidak diperlukan pilihan sumber media eksplisit).

Implementasi otomotif mungkin juga perlu membuat patch audio antara dua port perangkat. Untuk melakukannya, Anda harus mendeklarasikan port perangkat dan kemungkinan rute di audio_policy_configuration.xml terlebih dahulu, lalu mengaitkan mixport dengan port perangkat.

Contoh konfigurasi

Lihat contoh konfigurasi ini, device/generic/car/emulator/audio/audio_policy_configuration.xml.

<audioPolicyConfiguration>
    <modules>
        <module name="primary" halVersion="3.0">
            <attachedDevices>
                <item>bus0_media_out</item>
                <item>bus1_audio_patch_test_in</item>
            </attachedDevices>
            <mixPorts>
                <mixPort name="mixport_bus0_media_out" role="source"
                        flags="AUDIO_OUTPUT_FLAG_PRIMARY">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000"
                            channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </mixPort>
                <mixPort name="mixport_audio_patch_in" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                           samplingRates="48000"
                           channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
                </mixPort>
            </mixPorts>
            <devicePorts>
                <devicePort tagName="bus0_media_out" role="sink" type="AUDIO_DEVICE_OUT_BUS"
                        address="bus0_media_out">
                    <profile balance="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                    <gains>
                        <gain name="" mode="AUDIO_GAIN_MODE_JOINT"
                                minValueMB="-8400" maxValueMB="4000" defaultValueMB="0" stepValueMB="100"/>
                    </gains>
                </devicePort>
                <devicePort tagName="bus1_audio_patch_test_in" type="AUDIO_DEVICE_IN_BUS" role="source"
                        address="bus1_audio_patch_test_in">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_IN_STEREO"/>
                    <gains>
                        <gain name="" mode="AUDIO_GAIN_MODE_JOINT"
                                minValueMB="-8400" maxValueMB="4000" defaultValueMB="0" stepValueMB="100"/>
                    </gains>
                </devicePort>
            </devicePorts>
            <routes>
                <route type="mix" sink="bus0_media_out" sources="mixport_bus0_media_out,bus1_audio_patch_test_in"/>
                <route type="mix" sink="mixport_audio_patch_in" sources="bus1_audio_patch_test_in"/>
            </routes>
        </module>
    </modules>
</audioPolicyConfiguration>

Audio driver API

Anda dapat menggunakan getExternalSources() untuk mengambil daftar sumber yang tersedia (diidentifikasi berdasarkan alamat), lalu membuat patch audio antara sumber ini dan port sink berdasarkan penggunaan audio. Titik entri yang sesuai di Audio HAL muncul di IDevice.hal:

Interface IDevice {
...
/
*   Creates an audio patch between several source and sink ports.  The handle
*   is allocated by the HAL and must be unique for this audio HAL module.
*
*   @param sources patch sources.
*   @param sinks patch sinks.
*   @return retval operation completion status.
*   @return patch created patch handle.
*/
createAudioPatch(vec<AudioPortConfig> sources, vec<AudioPortConfig> sinks)
       generates (Result retval, AudioPatchHandle patch);

*   Release an audio patch.
*
*   @param patch patch handle.
*   @return retval operation completion status.
*/
releaseAudioPatch(AudioPatchHandle patch) generates (Result retval);
...
}

Penyetel radio

Saat membuat aplikasi radio, sebaiknya gunakan HwAudioSource karena menangani pembuatan patch dan sesi media untuk menangani peristiwa tombol media. Beberapa sumber audio dapat dibuat untuk sumber dan atribut audio yang sama. Anda dapat memiliki satu untuk penggunaan radio biasa dan satu lagi untuk pengumuman lalu lintas.

Jika merekam FM_TUNER, di Android 11 izin untuk melakukannya diubah menjadi android.permission.CAPTURE_AUDIO_OUTPUT. Aplikasi tidak lagi melalui pemeriksaan izin OP_RECORD_AUDIO, yang hanya berlaku untuk mikrofon. Hal ini tidak akan memengaruhi aplikasi karena FM_TUNER sudah memerlukan izin SYSTEM_API untuk akses.

Lihat Menerapkan radio untuk mengetahui detail tentang membangun aplikasi radio.