在 AAOS 中連接輸入設備

您可以使用這些機制在 Android 中播放音訊:

每種機制都允許在 Android 中執行音訊播放。對於廣播播放或從輸入設備播放,這些選項可能還不夠,儘管每個選項都可以與音頻捕獲或MediaRecorder類結合使用,首先捕獲音頻,然後從 Android 播放。特別是對於系統應用程序,以下資訊可用於將輸入裝置連接到 AAOS 中的輸出混音器。

HwAudioSource播放器

HwAudioSource將音訊來源裝置直接連接到 Android 混音器。

動機

在 Android 中使用裝置到裝置或硬體音訊修補程式時可能會出現一些限制。每個選項都無法接收媒體鍵事件,例如PLAYPAUSESTOP ,並且因為它們繞過 Android 的音訊堆疊,所以每個選項都需要硬體將補丁混合到來自 Android 的其他音訊中。

使用 HwAudioSource

HwAudioSource是一種新型播放器,設計為軟體修補程式。這使得使用該播放器的應用程式能夠接收媒體按鍵事件,並由 Android 混合和路由輸出流。

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

音頻 HAL 的更改

對於這個新播放器,請考慮對音訊 HAL 的這些期望。例如, device/generic/car/emulator/audio/driver/audio_hw.c

  • adev_create_audio_patch期望請求建立從裝置到混音器的音訊補丁。

  • adev_open_input_stream期望audio_sourceAUDIO_SOURCE_FM_TUNER

  • in_read以廣播無線電音訊資料填滿音訊緩衝區。

我們建議您在audio_policy_configuration.xml中配置類型為AUDIO_DEVICE_IN_FM_TUNER調諧器設備:

<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>

透過此裝置配置,您可以透過使用AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTSAudioDeviceInfo.TYPE_FM_TUNER結合使用來方便地尋找 FM 收音機輸入裝置。

建立音訊補丁

您可以在兩個音訊連接埠(混合連接埠或裝置連接埠)之間建立音訊補丁。通常,從混合端口到設備端口的音訊補丁用於播放,而相反方向用於捕獲。

例如,將音訊樣本從FM_TUNER來源直接路由到媒體接收器的音訊修補程式會繞過軟體混音器。然後,您必須使用硬體混音器來混合來自 Android 和FM_TUNER的音訊樣本以供接收器使用。直接從FM_TUNER來源到媒體接收器建立音訊補丁時:

  • 音量控制適用於媒體接收器,並且應該影響 Android 和FM_TUNER音訊。

  • 用戶可以透過簡單的應用程式切換在 Android 和FM_TUNER音訊之間切換(不需要明確的媒體來源選擇)。

汽車實施可能還需要在兩個設備連接埠之間建立音訊補丁。為此,您必須先在audio_policy_configuration.xml中聲明裝置連接埠和可能的路由,然後將混合連接埠與裝置連接埠關聯。

配置範例

請參閱此範例配置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>

音訊驅動API

您可以使用getExternalSources()檢索可用來源的清單(透過位址識別),然後根據音訊使用情況在這些來源和接收器連接埠之間建立音訊補丁。音頻 HAL 上的相應入口點出現在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);
...
}

收音機調諧器

建立廣播應用程式時,我們建議您使用HwAudioSource ,因為它可以處理建立補丁以及媒體會話來處理媒體鍵事件。可以為相同的來源和音訊屬性建立多個音訊來源。可以使用一台用於常規無線電使用,也可以使用另一台用於交通廣播。

如果錄製FM_TUNER ,在 Android 11 中,執行權限已變更為android.permission.CAPTURE_AUDIO_OUTPUT 。它不再經過僅適用於麥克風的OP_RECORD_AUDIO權限檢查。這不會影響應用程序,因為FM_TUNER已經需要SYSTEM_API存取權限。

有關建立無線電應用程式的詳細信息,請參閱實施無線電