Cómo bloquear búferes sin indicar con AutoSingleLayer

En Android 13, se agrega una configuración nueva llamada AutoSingleLayer para bloquear búferes sin indicar. Esta configuración permite que SurfaceFlinger bloquee un búfer sin indicar cuando se actualiza una sola capa, y no en los casos que ocurren entre capas, como cambios de geometría o transacciones de sincronización.

Antes de Android 13, la marca debug.sf.latch_unsignaled en AOSP permitía que SurfaceFlinger bloqueara todos los búferes sin señalizar, independientemente del caso de uso. Cuando se habilita este parámetro de configuración, se producen efectos secundarios no deseados, como la interrupción de las transacciones de sincronización y la congelación de toda la pantalla mientras se espera a que se completen los búferes.

Con el modo AutoSingleLayer, solo se actualiza un búfer de una sola superficie en un fotograma. Este modo permite que los juegos y otras apps en pantalla completa se beneficien de la fijación de búferes sin señal y la reducción de la latencia de la app, sin verse afectados por las interrupciones de la pantalla.

Configuración del modo AutoSingleLayer

En Android 13, AutoSingleLayer es el modo predeterminado para la función de bloqueo de búferes sin indicar. Este modo se controla con la propiedad del sistema debug.sf.auto_latch_unsignaled.

SurfaceFlinger lee LatchUnsignaledConfig durante el inicio. Estas son las configuraciones posibles:

• LatchUnsignaledConfig::AutoSingleLayer

  En este modo predeterminado del AOSP, se permite bloquear búferes sin indicar cuando se actualiza una sola capa en un fotograma y la actualización solo incluye una actualización del búfer sin transacciones de sincronización ni cambios de geometría. En este modo, debug.sf.auto_latch_unsignaled se establece en true de forma predeterminada.

• LatchUnsignaledConfig::Disabled

  Este modo inhabilita el comportamiento de cierre sin señal y solo cierra las transacciones señaladas. Este modo también inhabilita el modo AutoSingleLayer. Para configurar este modo, establece debug.sf.latch_unsignaled y debug.sf.auto_latch_unsignaled en false.

• LatchUnsignaledConfig::Always

  En este modo, todos los búferes se fijan sin señal. Para configurar este modo, establece debug.sf.latch_unsignaled en true.

Prueba AutoSingleLayer

Para probar si un búfer está bloqueado sin señalizar, busca los siguientes registros de SurfaceFlinger en Perfetto:

Figura 1: Registro de un búfer bloqueado sin indicar en Perfetto