В этой статье описаны альтернативы созданию проигрывателя.
Плеер 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
и связать смешанные порты с этими портами устройств.
Пример конфигурации
См. также 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
.