Предпочтительные атрибуты микшера на USB-устройствах

В Android 14 доступны API для разработчиков , которые приложения могут использовать для запроса и настройки предпочтительных атрибутов микшера для воспроизведения звука через USB. Эти атрибуты микшера улучшают качество воспроизведения звука через USB, позволяя приложениям настраивать аудиоформат, маску канала, частоту дискретизации и поведение микшера. Благодаря использованию API микшера на поддерживаемых USB-устройствах пользователи могут воспроизводить аудио с меньшей задержкой и получать аудиоконтент более высокого разрешения.

Эта функция также обеспечивает поддержку опционального режима микшера воспроизведения Bit-Perfect для USB-устройств. Режим Bit-Perfect позволяет воспроизводить аудиоформаты Master Quality Authenticated (MQA) и Direct-Stream Digital (DSD) на совместимых цифро-аналоговых преобразователях (ЦАП).

Интерфейс

Менеджер аудиополитик управляет атрибутами микшера в фреймворке. Класс AudioMixerAttributes представляет атрибуты микшера. Класс AudioMixerAttributes включает объект AudioFormat , который описывает формат аудиоданных, маску канала и частоту дискретизации микшера. По умолчанию фреймворк определяет поведение микшера, который микширует все аудиоисточники и применяет регулировку громкости и эффекты.

Если микшер использует режим BIT_PERFECT , система отправляет аудиоконтент без изменений через аудиофреймворк, HAL и, опционально, цифровой сигнальный процессор (DSP) из API на USB-устройство. Режим BIT_PERFECT поддерживает кодированные форматы, такие как MQA или DSD, в которых любое масштабирование громкости или микширование может исказить смысл данных.

Когда приложения настраивают атрибуты микшера, фреймворк при необходимости заново открывает выходной поток с новыми атрибутами. На следующем рисунке показан интерфейс между приложением, фреймворком и HAL при настройке атрибутов микшера:

Рисунок 1. Интерфейс между приложением, фреймворком и HAL.

Выполнение

Реализация предпочтительных атрибутов микшера, кроме атрибута BIT_PERFECT , для USB-аудио является обязательной для Android 14.

Предпочтительные атрибуты микшера

Для поддержки предпочтительных атрибутов микшера поставщики должны поддерживать маршрутизацию USB-устройств к порту динамического микширования следующим образом:

1. Определите порт динамического микширования в usb_audio_policy_configuration.xml .

2. Объявите возможность маршрутизации USB-устройств к портам динамического микширования либо в конфигурации политики звука , либо в методах AIDL getAudioPorts и getAudioRoutes .

См. эталонную реализацию USB-аудио HAL в файле hardware/libhardware/modules/usbaudio . Пример порта динамического микширования см. в frameworks/av/services/audiopolicy/config/usb_audio_policy_configuration.xml .

Атрибут бит-совершенного воспроизведения

Атрибут побитового воспроизведения необязателен и поддерживается только в реализации Audio HAL на базе AIDL. Для поддержки побитового воспроизведения поставщики должны добавить флаг побитового выхода AUDIO_OUTPUT_FLAG_BIT_PERFECT к порту динамического микширования, который может быть направлен на USB-устройство.

В следующем примере кода показано использование флага AUDIO_OUTPUT_FLAG_BIT_PERFECT в usb_audio_policy_configuration.xml :

<module name="usb" halVersion="2.0">
    <mixPorts>
        <mixPort name="hifi_output"
                 role="source" flags="AUDIO_OUTPUT_FLAG_BIT_PERFECT">
        </mixPort>
    </mixPorts>
    <devicePorts>
        <devicePort tagName="USB Device Out"
                    type="AUDIO_DEVICE_OUT_USB_DEVICE" role="sink">
        </devicePort>
    </devicePorts>
    <routes>
        <route type="mix" sink="USB Device Out"
               sources="hifi_output"/>
    </routes>
</module>

Если указан атрибут «bit-perfect playback», HAL должен гарантировать, что аудиопоток будет отправлен на USB-устройство без каких-либо изменений, то есть аудиопоток не должен подвергаться масштабированию громкости, преобразованию частоты дискретизации или обработке звука, а также не должен микшироваться в DSP-процессоре. В этом случае громкость регулируется аппаратно, поскольку фреймворк не предоставляет программных средств управления громкостью.

Проверка

Запустите тесты CTS в PreferredMixerAttributesTestActivity.java , чтобы проверить поддержку предпочтительных атрибутов микшера для USB-устройств.

Для проверки реализации атрибута BIT_PERFECT используйте USB-ЦАП, поддерживающие аудиоформаты MQA и DSD поверх импульсно-кодовой модуляции (PCM).