連結 AAOS 中的輸入裝置

您可以使用下列機制在 Android 中播放音訊:

每個機制都允許在 Android 中執行音訊播放作業。對於廣播播放或輸入裝置的播放作業,這些選項可能不夠用,但每個選項都可以搭配音訊擷取或 MediaRecorder 類別,先擷取音訊,然後透過 Android 播放。特別是系統應用程式,您可以使用下列資訊,將輸入裝置連線至 AAOS 中的輸出混合器。

HwAudioSource 播放器

HwAudioSource 會將音訊來源裝置直接連接至 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_INPUTS 搭配 AudioDeviceInfo.TYPE_FM_TUNER,輕鬆找出 FM 調頻收音機輸入裝置。

建立音訊修補程式

您可以在兩個音訊連接埠 (混合連接埠或裝置連接埠) 之間建立音訊修補程式。一般來說,從混合端口到裝置端口的音訊修補程序是用於播放,反之則用於擷取。

舉例來說,如果音訊修補程式將音訊樣本從 FM_TUNER 來源直接路由至媒體接收器,就會略過軟體混合器。接著,您必須使用硬體混合器,為接收器混合 Android 和 FM_TUNER 的音訊樣本。直接從 FM_TUNER 來源建立音訊修補程式至媒體接收器時:

  • 音量控制會套用至媒體匯出端,並應同時影響 Android 和 FM_TUNER 音訊。

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

汽車應用程式也可能需要在兩個裝置端口之間建立音訊修補程式。如要這樣做,您必須先在 audio_policy_configuration.xml 中宣告裝置通訊埠和可能的路徑,然後將 mixport 與裝置通訊埠建立關聯。

設定範例

請參閱這份範例設定,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 存取權,因此這項變更不會影響應用程式。

如要進一步瞭解如何建構廣播電台應用程式,請參閱「實作廣播電台」。