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

Se usó la API de Cloud Translation para traducir esta página.

Banderas AAOS de configuración de audio,Banderas AAOS de configuración de audio

El sistema operativo Android Automotive (AAOS) utiliza indicadores y configuraciones para habilitar diferentes funciones, desde el enrutamiento dinámico hasta indicadores de funciones más genéricas, como el control de volumen del servicio de automóvil. Aquí se describen los indicadores de configuración actuales de AAOS para la gestión de audio.

Bandera	Objetivo
`audioUseDynamicRouting`	Definido en el archivo de configuración del servicio de automóvil para habilitar el enrutamiento AAOS . La configuración debe establecerse en `true` . Cuando es `false` , el enrutamiento y gran parte de `CarAudioService` se desactivan y el sistema operativo vuelve al comportamiento predeterminado descrito en Configuración de políticas de audio .
`audioUseCarVolumeGroupMuting`	Definido en el archivo de configuración del servicio de automóvil para permitir el silenciamiento de grupos de volúmenes individuales. Cuando se establece en `false` (el valor predeterminado), se desactiva el silenciamiento de grupos de volúmenes individuales. En cambio, silenciar alterna el silencio maestro. Cuando se establece en `true` , se habilita el silenciamiento del grupo de volumen del automóvil y cada grupo de volumen individual se puede silenciar por separado. Cuando es `true` , el silenciamiento del grupo de volumen debe implementarse en el control de audio HAL .
`audioUseHalDuckingSignals`	Definido en el archivo de configuración del servicio de automóvil para habilitar la API `IAudioControl#onDevicesToDuckChange` para informar a HAL cuándo agacharse. Cuando `true` (valor predeterminado), la API recibe señales que indican qué dispositivos de salida evitar y qué usos mantienen el foco. Cuando `false` , no se llama a la API. No se llama a la API a menos que Audio Control HAL implemente reducción.
`config_oemCarService`	Definido en el archivo de configuración del servicio de automóvil, este es el nombre del componente para el servicio de personalización OEM. Los OEM pueden optar por implementar este servicio para personalizar las acciones de servicio del automóvil para diferentes políticas. Si los OEM optan por implementar este componente, deben implementar un servicio para ampliar `OemCarService` expuesto por car-lib y luego implementar los servicios de componentes requeridos. Específicamente para el servicio de audio para automóviles, los OEM pueden implementar cualquiera de los subservicios de audio para administrar la acción de audio. Para obtener más información, consulte Servicio de complementos de audio para el automóvil . Si el nombre del componente no es válido, `CarService` no se conectará a ningún servicio OEM. El nombre del componente no puede ser un paquete de terceros. Debe estar preinstalado.
`audioVolumeAdjustmentContextsVersion`	Definido en el archivo de configuración del servicio de automóvil, configuración para seleccionar la versión de la lista de prioridades del contexto de ajuste de volumen. La versión 1 incluye todos los contextos de audio, en este orden: `NAVIGATION` `CALL` `MUSIC` `ANNOUNCEMENT` `VOICE_COMMAND` `CALL_RING` `SYSTEM_SOUND` `SAFETY` `ALARM` `NOTIFICATION` `VEHICLE_STATUSEMERGENCY` La versión 2 está limitada a los siguientes contextos, en este orden. La versión predeterminada es `1` . `CALL` `MUSIC` `ANNOUNCEMENT` `VOICE_COMMAND`
`audioPersistMasterMuteState`	Definido en el archivo de configuración del servicio de automóvil, configuración para persistir en el estado de silencio global. Cuando `true` (el valor predeterminado), Android restaura el estado de silencio global al arrancar. Cuando `audioUseCarVolumeGroupMuting` es `true` , esto no tiene ningún impacto en los cambios de silencio persistentes, ya que los cambios de silencio se basan en grupos de volúmenes individuales. El valor predeterminado se establece en `true` y se debe sobrescribir cuando el silencio maestro no se debe conservar para un dispositivo.
`audioVolumeKeyEventTimeoutMs`	Definido en el archivo de configuración del servicio de automóvil, configuración para indicar el tiempo de espera en milisegundos mientras un grupo de volumen de automóvil se considera activo para cambios de control de volumen durante eventos de tecla de volumen. La configuración se utiliza de la siguiente manera: El tiempo de espera se utiliza para determinar si una reproducción (volumen de audio asociado con el uso de audio de la reproducción) aún se puede considerar para la selección automática de volumen después de que haya dejado de reproducirse. El tiempo de espera también se utiliza como la duración de la pausa requerida entre los ajustes automáticos de volumen para cambiar lo que el usuario está ajustando. El valor predeterminado es `3000` milisegundos y los OEM deben ajustarlo para adaptar la experiencia del usuario.
`audioUseCarVolumeGroupEvent`	Definido en el archivo de configuración del servicio de automóvil, configuración para habilitar eventos de devolución de llamada a grupos de volúmenes. Cuando es `true` , los clientes reciben una devolución de llamada a través de `ICarVolumeGroupEvent` a eventos que afectan a los grupos de volúmenes. Cuando está habilitado: Recomendamos encarecidamente que los proveedores también admitan `IAudioControl#setModuleChangeCallback` e `IAudioControl#registerGainCallback` para eventos y cambios en el hardware de audio. Cuando `CarVolumeCallback` y `CarVolumeGroupEventCallback` están registrados por la misma aplicación, el índice del grupo de volumen y las devoluciones de llamada de silencio del grupo de volumen pasarán únicamente por `CarVolumeGroupEventCallback` . Por lo tanto, recomendamos encarecidamente que todas las aplicaciones migren a la nueva interfaz de devolución de llamada para garantizar un rendimiento constante. El valor predeterminado es `false` . Le recomendamos que establezca esto en `true` porque las API para admitir devoluciones de llamadas de volumen heredadas están en desuso y pronto se eliminarán por completo.
`config_useFixedVolume`	Definido en `frameworks/base/core/res/res/values/config.xml` . Debe establecerse en `true` para permitir que el servicio de audio del automóvil administre el control de volumen. Cuando el indicador `config_useFixedVolume` no está configurado o está configurado en `false` (el valor predeterminado), las aplicaciones pueden llamar a las API de administración de volumen `AudioManager` y cambiar el volumen por tipo de transmisión en el mezclador de software. Esto puede no ser deseable debido al efecto potencial en otras aplicaciones y al hecho de que la atenuación del volumen en el mezclador de software puede resultar en menos bits significativos disponibles en la señal cuando se recibe en el amplificador de hardware. Los dispositivos nuevos que no se han configurado y que están configurados en `true` reciben cambios de volumen a través de las API de volumen y silencio `AudioManager` .
`config_handleVolumeKeysInWindowManager`	Definido en `frameworks/base/core/res/res/values/config.xml` , debe establecerse en `true` para permitir que el servicio de audio del automóvil intercepte eventos de clave de volumen. Si se configura en `false` (el valor predeterminado), los eventos de la tecla de volumen se pueden reenviar a la aplicación de primer plano y pueden provocar resultados adversos en la gestión de eventos de la tecla de volumen fuera del servicio de audio del automóvil.

Configuraciones del servicio de audio del automóvil

Antes de Android 13, las configuraciones de los servicios de automóviles se sobrescribían con una superposición de configuración del producto (para obtener más información, consulte Personalización de la compilación con superposiciones de recursos ) para el archivo packages/services/Car/service/res/values/config.xml .

PRODUCT_PACKAGE_OVERLAYS := <path_to_overlay>

La ubicación del archivo de configuración desde <path_to_overlay> hasta la ubicación real debe incluir packages/services/Car/service/res/values/ .

RRO de servicio de automóviles

Desde Android 13, AAOS admite superposiciones de recursos en tiempo de ejecución . Utilice un RRO para cambiar el valor de la configuración de audio del automóvil. Por ejemplo, consulte los RRO para la referencia cuttlefish automotriz en device/google/cuttlefish/shared/auto/rro_overlay/ . La configuración audioUseDynamicRouting se anula en device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/res/values/config.xml .

<resources>
    <bool name="audioUseDynamicRouting">true</bool>
...

El mapa de superposición de recursos está contenido en device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/res/xml/overlays.xml :

<overlay>
...
  <item target="bool/audioUseDynamicRouting"
value="@bool/audioUseDynamicRouting" />
...
</overlay>

El manifiesto de superposición de recursos definido en device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/AndroidManifest.xml contiene el targetPackage configurado como com.android.car.updatable .

Consulte estos recursos para obtener más información:

API habilitada para funciones

El método devuelve true si la función está habilitada en el dispositivo; de lo contrario, es false . En la API CarAudioManager#isAudioFeatureEnabled , el parámetro pasado debe ser uno de:

AUDIO_FEATURE_DYNAMIC_ROUTING
AUDIO_FEATURE_VOLUME_GROUP_MUTING
AUDIO_FEATURE_OEM_AUDIO_SERVICE
AUDIO_FEATURE_VOLUME_GROUP_EVENTS
AUDIO_FEATURE_AUDIO_MIRRORING

Bandera	Objetivo
`audioUseDynamicRouting`	Definido en el archivo de configuración del servicio de automóvil para habilitar el enrutamiento AAOS . La configuración debe establecerse en `true` . Cuando es `false` , el enrutamiento y gran parte de `CarAudioService` se desactivan y el sistema operativo vuelve al comportamiento predeterminado descrito en Configuración de políticas de audio .
`audioUseCarVolumeGroupMuting`	Definido en el archivo de configuración del servicio de automóvil para permitir el silenciamiento de grupos de volúmenes individuales. Cuando se establece en `false` (el valor predeterminado), se desactiva el silenciamiento de grupos de volúmenes individuales. En cambio, silenciar alterna el silencio maestro. Cuando se establece en `true` , se habilita el silenciamiento del grupo de volumen del automóvil y cada grupo de volumen individual se puede silenciar por separado. Cuando es `true` , el silenciamiento del grupo de volumen debe implementarse en el control de audio HAL .
`audioUseHalDuckingSignals`	Definido en el archivo de configuración del servicio de automóvil para habilitar la API `IAudioControl#onDevicesToDuckChange` para informar a HAL cuándo agacharse. Cuando `true` (valor predeterminado), la API recibe señales que indican qué dispositivos de salida evitar y qué usos mantienen el foco. Cuando `false` , no se llama a la API. No se llama a la API a menos que Audio Control HAL implemente reducción.
`config_oemCarService`	Definido en el archivo de configuración del servicio de automóvil, este es el nombre del componente para el servicio de personalización OEM. Los OEM pueden optar por implementar este servicio para personalizar las acciones de servicio del automóvil para diferentes políticas. Si los OEM optan por implementar este componente, deben implementar un servicio para ampliar `OemCarService` expuesto por car-lib y luego implementar los servicios de componentes requeridos. Específicamente para el servicio de audio para automóviles, los OEM pueden implementar cualquiera de los subservicios de audio para administrar la acción de audio. Para obtener más información, consulte Servicio de complementos de audio para el automóvil . Si el nombre del componente no es válido, `CarService` no se conectará a ningún servicio OEM. El nombre del componente no puede ser un paquete de terceros. Debe estar preinstalado.
`audioVolumeAdjustmentContextsVersion`	Definido en el archivo de configuración del servicio de automóvil, configuración para seleccionar la versión de la lista de prioridades del contexto de ajuste de volumen. La versión 1 incluye todos los contextos de audio, en este orden: `NAVIGATION` `CALL` `MUSIC` `ANNOUNCEMENT` `VOICE_COMMAND` `CALL_RING` `SYSTEM_SOUND` `SAFETY` `ALARM` `NOTIFICATION` `VEHICLE_STATUSEMERGENCY` La versión 2 está limitada a los siguientes contextos, en este orden. La versión predeterminada es `1` . `CALL` `MUSIC` `ANNOUNCEMENT` `VOICE_COMMAND`
`audioPersistMasterMuteState`	Definido en el archivo de configuración del servicio de automóvil, configuración para persistir en el estado de silencio global. Cuando `true` (el valor predeterminado), Android restaura el estado de silencio global al arrancar. Cuando `audioUseCarVolumeGroupMuting` es `true` , esto no tiene ningún impacto en los cambios de silencio persistentes, ya que los cambios de silencio se basan en grupos de volúmenes individuales. El valor predeterminado se establece en `true` y se debe sobrescribir cuando el silencio maestro no se debe conservar para un dispositivo.
`audioVolumeKeyEventTimeoutMs`	Definido en el archivo de configuración del servicio de automóvil, configuración para indicar el tiempo de espera en milisegundos mientras un grupo de volumen de automóvil se considera activo para cambios de control de volumen durante eventos de tecla de volumen. La configuración se utiliza de la siguiente manera: El tiempo de espera se utiliza para determinar si una reproducción (volumen de audio asociado con el uso de audio de la reproducción) aún se puede considerar para la selección automática de volumen después de que haya dejado de reproducirse. El tiempo de espera también se utiliza como la duración de la pausa requerida entre los ajustes automáticos de volumen para cambiar lo que el usuario está ajustando. El valor predeterminado es `3000` milisegundos y los OEM deben ajustarlo para adaptar la experiencia del usuario.
`audioUseCarVolumeGroupEvent`	Definido en el archivo de configuración del servicio de automóvil, configuración para habilitar eventos de devolución de llamada a grupos de volúmenes. Cuando es `true` , los clientes reciben una devolución de llamada a través de `ICarVolumeGroupEvent` a eventos que afectan a los grupos de volúmenes. Cuando está habilitado: Recomendamos encarecidamente que los proveedores también admitan `IAudioControl#setModuleChangeCallback` e `IAudioControl#registerGainCallback` para eventos y cambios en el hardware de audio. Cuando `CarVolumeCallback` y `CarVolumeGroupEventCallback` están registrados por la misma aplicación, el índice del grupo de volumen y las devoluciones de llamada de silencio del grupo de volumen pasarán únicamente por `CarVolumeGroupEventCallback` . Por lo tanto, recomendamos encarecidamente que todas las aplicaciones migren a la nueva interfaz de devolución de llamada para garantizar un rendimiento constante. El valor predeterminado es `false` . Le recomendamos que establezca esto en `true` porque las API para admitir devoluciones de llamadas de volumen heredadas están en desuso y pronto se eliminarán por completo.
`config_useFixedVolume`	Definido en `frameworks/base/core/res/res/values/config.xml` . Debe establecerse en `true` para permitir que el servicio de audio del automóvil administre el control de volumen. Cuando el indicador `config_useFixedVolume` no está configurado o está configurado en `false` (el valor predeterminado), las aplicaciones pueden llamar a las API de administración de volumen `AudioManager` y cambiar el volumen por tipo de transmisión en el mezclador de software. Esto puede no ser deseable debido al efecto potencial en otras aplicaciones y al hecho de que la atenuación del volumen en el mezclador de software puede resultar en menos bits significativos disponibles en la señal cuando se recibe en el amplificador de hardware. Los dispositivos nuevos que no se han configurado y que están configurados en `true` reciben cambios de volumen a través de las API de volumen y silencio `AudioManager` .
`config_handleVolumeKeysInWindowManager`	Definido en `frameworks/base/core/res/res/values/config.xml` , debe establecerse en `true` para permitir que el servicio de audio del automóvil intercepte eventos de clave de volumen. Si se configura en `false` (el valor predeterminado), los eventos de la tecla de volumen se pueden reenviar a la aplicación de primer plano y pueden provocar resultados adversos en la gestión de eventos de la tecla de volumen fuera del servicio de audio del automóvil.