Для воспроизведения звука на 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_DEVICE_IN_FM_TUNER
в audio_policy_configuration.xml
:
<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>
С помощью этой конфигурации устройства вы можете упростить поиск устройства ввода FM-радио, используя AudioManager.getDevices(AudioManager.GET_DEVICES_INPUTS
совместно с AudioDeviceInfo.TYPE_FM_TUNER
.
Создание аудиопатчей
Вы можете создать аудиопатч между двумя аудиопортами, либо портом микширования, либо портом устройства. Обычно аудиопатч от порта микширования к порту устройства предназначен для воспроизведения, а обратное направление — для захвата.
Например, аудиопатч, который направляет аудиосэмплы из источника FM_TUNER
напрямую в медиаприемник, обходит программный микшер. Затем необходимо использовать аппаратный микшер для микширования аудиосэмплов из Android и FM_TUNER
для приемника. При создании аудиопатча напрямую из источника FM_TUNER
в медиаприемник:
Регулировка громкости применяется к приемнику мультимедиа и должна влиять как на Android, так и на звук
FM_TUNER
.Пользователи могут переключаться между Android и аудио
FM_TUNER
с помощью простого переключения приложений (явный выбор источника мультимедиа не требуется).
Автомобильные реализации также могут потребовать создания аудиопатча между двумя портами устройств. Для этого необходимо сначала объявить порты устройств и возможные маршруты в audio_policy_configuration.xml
, а затем связать mixports с портами устройств.
Пример конфигурации
См. этот пример конфигурации, 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);
...
}
Радио тюнер
При создании приложения радио мы рекомендуем использовать HwAudioSource
, поскольку он обрабатывает как создание патча, так и сеанса мультимедиа для обработки ключевых событий мультимедиа. Можно создать несколько аудиоисточников для одних и тех же атрибутов источника и аудио. Можно иметь один для обычного использования радио, а второй для объявлений о дорожном движении.
Если записывать FM_TUNER
, в Android 11 разрешение на выполнение было изменено на android.permission.CAPTURE_AUDIO_OUTPUT
. Он больше не проходит проверку разрешения OP_RECORD_AUDIO
, которая применяется только к микрофонам. Это не должно повлиять на приложения, поскольку FM_TUNER
уже требует разрешения SYSTEM_API
для доступа.
Подробную информацию о создании приложения для радио см. в разделе Внедрение радио .