Google 致力于为黑人社区推动种族平等。查看具体举措

创建播放器的替代方案

本文介绍了您在选择不创建播放器时可选用的替代方案。

HwAudioSource 播放器

HwAudioSource 将音频来源设备直接连接到 Android 混音器。

在 Android 中使用“设备到设备”音频通路或硬件音频通路时,可能会存在一些限制。这些音频通路会无法接收 PLAY、PAUSE 和 STOP 等媒体键事件,因为音频通路会绕过 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_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 音频之间进行切换(不必明确选择媒体来源)。

Automotive 实现可能还需要在两个设备端口之间创建音频通路。为此,您必须先在 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);
...
}

注意:这些 API 钩子从 AUDIO_DEVICE_API_VERSION_3_0 便已开始提供。如需了解详情,请参阅 device/generic/car/emulator/audio/driver/audio_hw.c