Atributos preferidos del mezclador en dispositivos USB

Android 14 ofrece APIs para desarrolladores que pueden usarse en apps para consultar y configurar los atributos preferidos del mezclador para la reproducción de audio por USB. Estos atributos preferidos del mezclador mejoran la experiencia de reproducción de audio USB, ya que permiten que las apps establezcan el formato de audio, la máscara de canales, la tasa de muestreo y el comportamiento del mezclador. Con el uso de las APIs de mezclador preferidas en dispositivos USB compatibles, los usuarios pueden obtener una reproducción de audio con menor latencia y contenido de audio de mayor resolución.

Esta función también admite el comportamiento opcional del mezclador de reproducción de bits perfectos para dispositivos USB. El modo de precisión de bits habilita la reproducción de formatos de calidad maestra autenticada (MQA) y de transmisión digital directa (DSD) en convertidores digitales a analógicos (DAC) compatibles.

Interfaz

El Administrador de políticas de audio controla los atributos del mezclador en el framework. La clase AudioMixerAttributes representa los atributos del mezclador. La clase AudioMixerAttributes incluye un objeto AudioFormat que describe el formato de datos de audio, la máscara de canales y la tasa de muestreo del mezclador. De forma predeterminada, el framework determina el comportamiento del mezclador, que combina todas las fuentes de audio y aplica control de volumen y efectos.

Si el comportamiento del mezclador usa el modo BIT_PERFECT, el sistema envía el contenido de audio sin modificaciones a través del framework de audio, HAL y, de manera opcional, el procesador de señal digital (DSP), desde la API hasta el dispositivo USB. El modo BIT_PERFECT admite formatos codificados, como MQA o DSD, en los que cualquier escalamiento o combinación de volumen puede destruir el significado de los datos.

Cuando las apps configuran atributos del mezclador, el framework vuelve a abrir el flujo de salida con atributos nuevos, si es necesario. En la siguiente figura, se muestra la interfaz entre la app, el framework y el HAL cuando se configuran los atributos del mezclador:

Figura 1: Interfaz entre la app, el framework y el HAL.

Implementación

La implementación de atributos preferidos del mezclador, además del atributo BIT_PERFECT, para el audio USB es obligatoria en Android 14.

Atributos preferidos del mezclador

Para admitir los atributos preferidos del mezclador, los proveedores deben admitir el enrutamiento de dispositivos USB al puerto de combinación dinámica, de la siguiente manera:

1. Define el puerto de combinación dinámico en usb_audio_policy_configuration.xml.

2. Declara la capacidad de enrutar dispositivos USB a puertos de combinación dinámica en la configuración de la política de audio o en los métodos de AIDL getAudioPorts y getAudioRoutes.

Nota: Si la funcionalidad de audio USB se migra al HAL principal, define el puerto de combinación dinámico y el enrutamiento de audio USB en el archivo de configuración de la política de audio para tu HAL principal.

Consulta la implementación de referencia del HAL de audio USB en hardware/libhardware/modules/usbaudio. Consulta un ejemplo de un puerto de combinación dinámico en frameworks/av/services/audiopolicy/config/usb_audio_policy_configuration.xml.

Nota: Solo los dispositivos USB pueden establecer los atributos preferidos del mezclador.

Atributo de reproducción de bits perfectos

El atributo de reproducción de bits perfectos es opcional y solo se admite en la implementación de AIDL del HAL de audio. Para admitir la reproducción bit a bit, los proveedores deben agregar la marca de salida bit a bit AUDIO_OUTPUT_FLAG_BIT_PERFECT al puerto de combinación dinámico que se puede enrutar al dispositivo USB.

En la siguiente muestra de código, se muestra el uso de la marca AUDIO_OUTPUT_FLAG_BIT_PERFECT en 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>

Si se especifica el atributo de reproducción de bits perfectos, el HAL debe garantizar que la transmisión de audio se envíe al dispositivo USB sin ninguna modificación, es decir, la transmisión de audio no debe tener ninguna escala de volumen, conversión de tasa de muestreo ni efectos de procesamiento de audio, y no debe mezclarse en el DSP. En este caso, el hardware controla el volumen, ya que el framework no proporciona ningún control de volumen de software.

Nota: Sin el atributo de reproducción de bits perfecto, las apps no pueden transmitir contenido de alta resolución, como DSD y MQA, a través del framework de audio.

Validación

Ejecuta las pruebas de CTS en PreferredMixerAttributesTestActivity.java para validar la compatibilidad con los atributos preferidos del mezclador para dispositivos USB.

Para validar la implementación del atributo BIT_PERFECT, usa DAC USB que admitan MQA y DSD a través de formatos de audio de modulación por impulsos codificados (PCM).