Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Configuración de políticas de audio

La versión de Android 10 incluye una refactorización significativa del administrador de políticas de audio para proporcionar más flexibilidad para admitir casos de uso automotrices complejos:

  • Estrategias de enrutamiento específicas de OEM.
  • Grupos de volumen personalizables para grupos de tipos de corrientes heredados que utilizan las mismas curvas de volumen.
  • Estrategias de enrutamiento declaradas por el motor de políticas de audio en lugar de estar codificadas de forma rígida.
  • Curvas de volumen y grupos gestionados por el motor de políticas de audio.
  • Refactorización interna preparándose para una futura división entre código común y código configurable y ofreciendo una gestión de dispositivos de audio más rica. Por ejemplo, el uso de todas las propiedades del dispositivo, no solo su tipo en las reglas de política.

Android 7.0 introdujo un formato de archivo de configuración de políticas de audio (XML) para describir su topología de audio.

Las versiones anteriores de Android requieren el uso de device/<company>/<device>/audio/audio_policy.conf para declarar los dispositivos de audio presente en el producto (se puede ver un ejemplo de este archivo para el hardware de audio Galaxy Nexus en el device/samsung/tuna/audio/audio_policy.conf ). Sin embargo, CONF es un formato simple y propietario que es demasiado limitado para describir topologías complejas para verticales como televisores y automóviles.

Android 7.0 obsoleta audio_policy.conf y mayor soporte para definir una topología de audio utilizando un formato de archivo XML que es más legible, tiene una amplia gama de herramientas de edición y análisis, y es lo suficientemente flexible para describir topologías complejas de audio. Android 7.0 usa USE_XML_AUDIO_POLICY_CONF bandera de acumulación para elegir el formato XML de los archivos de configuración.

Ventajas del formato XML

Como en el archivo CONF, el archivo XML permite definir el número y los tipos de perfiles de flujo de entrada y salida, dispositivos utilizables para reproducción y captura, y atributos de audio. Además, el formato XML ofrece las siguientes mejoras:

  • En Android 10, se permite más de una aplicación de grabación activa simultáneamente.
    • El inicio de la grabación nunca se rechaza debido a una situación de concurrencia.
    • El registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb) notifica a los clientes de devolución de llamada de cambio de rutas de captura.
  • En las siguientes situaciones, un cliente obtiene muestras de audio silenciosas:
    • Un caso sensible a la privacidad uso (por ejemplo, VOICE_COMMUNICATION ) está activo.
    • El cliente no tiene un servicio en primer plano ni una IU en primer plano.
    • Los roles especiales son reconocidos por la política:
      • Servicio de accesibilidad: puede grabar incluso si está activo un caso de uso sensible a la privacidad.
      • Asistente: se considera sensible a la privacidad si la interfaz de usuario está en la parte superior.
  • Los perfiles de audio tienen una estructura similar a los descriptores de audio simples HDMI, lo que permite un conjunto diferente de frecuencias de muestreo / máscaras de canal para cada formato de audio.
  • Hay definiciones explícitas para todas las conexiones posibles entre dispositivos y transmisiones. Anteriormente, una regla implícita permitía conectar todos los dispositivos conectados al mismo módulo HAL, evitando que la política de audio controlara las conexiones solicitadas con las API de parches de audio. En el formato XML, la descripción de la topología define las limitaciones de conexión.
  • Incluye soporte para A2DP evita la repetición estándar, USB o el redireccionamiento de presentar definiciones.
  • Las curvas de volumen son personalizables. Anteriormente, las tablas de volumen estaban codificadas. En formato XML, las tablas de volumen se describen y se pueden personalizar.

La plantilla de frameworks/av/services/audiopolicy/config/audio_policy_configuration.xml muestra muchas de estas características en uso.

Formato de archivo y ubicación

El nuevo archivo de configuración de políticas de audio es audio_policy_configuration.xml y se encuentra en /system/etc . Los siguientes ejemplos muestran una configuración de política de audio simple en el formato de archivo XML para Android 12 y para las versiones anteriores a Android 12.

La estructura de nivel superior contiene módulos que corresponden a cada módulo de hardware de audio HAL, donde cada módulo tiene una lista de puertos de mezcla, puertos de dispositivo y rutas:

  • Mix puertos describen los posibles perfiles de configuración para los flujos que se pueden abrir en el HAL audio para la reproducción y captura.
  • Puertos de dispositivos describen los dispositivos que se pueden conectar con su tipo (y, opcionalmente, de direcciones y de audio propiedades, si es relevante).
  • Rutas se separa del descriptor puerto mezcla, lo que permite la descripción de rutas de dispositivo a dispositivo o corriente al dispositivo.

Las tablas de volumen son listas simples de puntos que definen la curva utilizada para traducir de un índice de IU a un volumen en dB. Un archivo de inclusión independiente proporciona curvas predeterminadas, pero se puede sobrescribir cada curva para un caso de uso y categoría de dispositivo determinados.

Inclusiones de archivos

El método de inclusiones XML (XInclude) se puede utilizar para incluir información de configuración de políticas de audio ubicada en otros archivos XML. Todos los archivos incluidos deben seguir la estructura descrita anteriormente con las siguientes restricciones:

  • Los archivos solo pueden contener elementos de nivel superior.
  • Los archivos no pueden contener elementos XInclude.

El uso incluye evitar copiar la información de configuración del módulo de audio HAL del Proyecto de código abierto de Android (AOSP) estándar en todos los archivos de configuración de políticas de audio (que es propenso a errores). Se proporciona un archivo XML de configuración de política de audio estándar para las siguientes HAL de audio:

  • A2DP: a2dp_audio_policy_configuration.xml
  • El redireccionamiento de submezcla: rsubmix_audio_policy_configuration.xml
  • USB: usb_audio_policy_configuration.xml

Organización del código de la política de audio

AudioPolicyManager.cpp se divide en varios módulos para que sea fácil de mantener y configurar. La organización de frameworks/av/services/audiopolicy incluye los siguientes módulos.

Módulo Descripción
/managerdefault Incluye las interfaces genéricas y la implementación de comportamientos comunes a todas las aplicaciones. Al igual que en AudioPolicyManager.cpp con la funcionalidad del motor y conceptos comunes abstraído.
/common Define clases base (por ejemplo, estructuras de datos para perfiles de flujo de audio de entrada y salida, descriptores de dispositivos de audio, parches de audio y puertos de audio). Esto se definió anteriormente dentro de AudioPolicyManager.cpp .
/engine

Implementa las reglas que definen qué dispositivo y volúmenes deben usarse para un caso de uso determinado. Implementa una interfaz estándar con la parte genérica, como para obtener el dispositivo apropiado para un caso de uso de reproducción o captura determinado, o para configurar dispositivos conectados o un estado externo (es decir, un estado de llamada de uso forzado) que puede alterar el enrutamiento. decisión.

Disponible en dos versiones: configurable y predeterminado. Para obtener la información sobre cómo seleccionar la versión, consulte Configuración mediante marco de parámetros .

/engineconfigurable Implementación del motor de políticas que se basa en el marco de parámetros (ver más abajo). La configuración se basa en el marco de parámetros y donde la política se define mediante archivos XML.
/enginedefault Implementación del motor de políticas basada en implementaciones anteriores de Android Audio Policy Manager. Este es el valor predeterminado e incluye reglas codificadas que corresponden a las implementaciones de Nexus y AOSP.
/service Incluye interfaces de enlace, subprocesos e implementación de bloqueo con la interfaz para el resto del marco.

Configuración mediante el marco de parámetros

El código de la política de audio está organizado para que sea fácil de entender y mantener, al mismo tiempo que admite una política de audio definida completamente por archivos de configuración. El diseño de la política de organización y audio se basa en el Marco de parámetros de Intel, un marco basado en complementos y reglas para el manejo de parámetros.

El uso de la política de audio configurable permite a los fabricantes OEM:

  • Describe la estructura de un sistema y sus parámetros en XML.
  • Escriba (en C ++) o reutilice un backend (complemento) para acceder a los parámetros descritos.
  • Definir (en XML o en un lenguaje específico de dominio) condiciones / reglas sobre las cuales un parámetro dado debe tomar un valor dado.

AOSP incluye un ejemplo de un archivo de configuración de la política de audio que utiliza el Marco de parámetros en Frameworks/av/services/audiopolicy/engineconfigurable/parameter-framework/example/Settings/PolicyConfigurableDomains.xml . Para más detalles, consulte la documentación de Intel en el marco de parámetros .

En Android 10 o inferior, la política de audio configurable se selecciona mediante la opción de generación USE_CONFIGURABLE_AUDIO_POLICY . En Android 11 o superior, la versión del motor de políticas de audio se selecciona en el audio_policy_configuration.xml archivo. Para seleccionar el motor de políticas de audio configurable, establezca el valor de la engine_library atributo del globalConfiguration elemento a configurable como en el siguiente ejemplo:

<audioPolicyConfiguration>
    <globalConfiguration engine_library="configurable" />
...
</audioPolicyConfiguration>

API de enrutamiento de políticas de audio

Android 6.0 introdujo una API pública de enumeración y selección que se encuentra en la parte superior de la infraestructura del puerto de audio / parche de audio y permite a los desarrolladores de aplicaciones indicar una preferencia por una salida o entrada de dispositivo específica para pistas o registros de audio conectados.

En Android 7.0, la API de enumeración y selección se verifica mediante pruebas de CTS y se amplía para incluir enrutamiento para transmisiones de audio nativas C / C ++ (OpenSL ES). El encaminamiento de corrientes nativas continúa realizándose en Java, con la adición de un AudioRouting interfaz que remplaza, cosechadoras, y desaprueba los métodos de encaminamiento explícito que eran específicos para las AudioTrack y AudioRecord clases.

Para más detalles sobre la API de enumeración y selección, se refieren a interfaces de configuración de Android y OpenSLES_AndroidConfiguration.h . Para más detalles sobre el enrutamiento de audio, consulte AudioRouting .

Soporte multicanal

Si su hardware y controlador admiten audio multicanal a través de HDMI, puede enviar la transmisión de audio directamente al hardware de audio (esto evita el mezclador AudioFlinger para que no se mezcle en dos canales). La HAL de audio debe exponer si un perfil de transmisión de salida admite capacidades de audio multicanal. Si el HAL expone sus capacidades, el administrador de políticas predeterminado permite la reproducción multicanal a través de HDMI. Para detalles de implementación, vea device/samsung/tuna/audio/audio_hw.c .

Para especificar que su producto contiene una salida de audio multicanal, edite el archivo de configuración de la política de audio para describir la salida multicanal de su producto. El siguiente ejemplo de frameworks/av/services/audiopolicy/config/primary_audio_policy_configuration_tv.xml muestra una máscara dinámica de canales, lo que significa que el gestor de políticas de audio consulta las máscaras de canales soportados por el fregadero después de la conexión HDMI.

También puede especificar un canal estático máscara como AUDIO_CHANNEL_OUT_5POINT1 . El mezclador de AudioFlinger mezcla el contenido a estéreo automáticamente cuando se envía a un dispositivo de audio que no admite audio multicanal.

Códecs de medios

Asegúrese de que los códecs de audio compatibles con su hardware y controladores estén correctamente declarados para su producto. Para más detalles, véase La exposición de codecs para el Marco .