您可以使用这些机制在 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
访问权限。
有关构建无线电应用程序的详细信息,请参阅实施无线电。