此页面由 Cloud Translation API 翻译。

在 AAOS 中连接输入设备

您可以使用这些机制在 Android 中播放音频：

每种机制都允许在 Android 中执行音频播放。对于广播播放或从输入设备播放，这些选项可能还不够，尽管每个选项都可以与音频捕获或MediaRecorder类结合使用，首先捕获音频，然后从 Android 播放。特别是对于系统应用程序，以下信息可用于将输入设备连接到 AAOS 中的输出混音器。

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音频之间切换（不需要明确的媒体源选择）。

汽车实施可能还需要在两个设备端口之间创建音频补丁。为此，您必须首先在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访问权限。

有关构建无线电应用程序的详细信息，请参阅实施无线电。