Подключите устройство ввода в 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_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 , поскольку он обрабатывает как создание патча, так и медиасессию для обработки событий нажатия медиаклавиш. Для одного и того же источника и атрибутов звука можно создать несколько источников звука. Можно использовать один источник для обычного радиовещания, а второй — для дорожных объявлений.

В Android 11 разрешение на запись FM_TUNER было изменено на android.permission.CAPTURE_AUDIO_OUTPUT . Проверка разрешения OP_RECORD_AUDIO больше не выполняется, она применяется только к микрофонам. Это не должно повлиять на работу приложений, поскольку FM_TUNER уже требует разрешения SYSTEM_API для доступа.

Подробную информацию о создании радиоприложения см. в разделе «Реализация радио».