本頁面由 Cloud Translation API 翻譯而成。

創建播放器的替代方法

本文介紹了創建播放器的替代方法。

HwAudioSource 播放器

HwAudioSource 將音頻源設備直接連接到 Android 混音器。

在 Android 中使用設備到設備或硬件音頻補丁時可能會出現一些限制。它們無法接收 PLAY、PAUSE 和 STOP 等媒體鍵事件，並且由於它們繞過 Android 的音頻堆棧，它們需要硬件將補丁程序混合到來自 Android 的其他音頻中。

使用硬件音頻源

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_source 為AUDIO_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中聲明設備端口和可能的路由，並將混合端口與這些設備端口相關聯。

示例配置

另請參閱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()檢索可用源列表（由地址標識），然後根據音頻使用情況在這些源和接收器端口之間創建音頻補丁。 Audio 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);
...
}

注意：這些 API 掛鉤從AUDIO_DEVICE_API_VERSION_3_0開始可用。有關詳細信息，請參閱device/generic/car/emulator/audio/driver/audio_hw.c 。