TV en espera

En Android 11, el modo de suspensión inatento es una función de ahorro de energía que permite establecer un tiempo de espera de inactividad del usuario, tras el cual la pantalla se apaga, incluso si las ventanas con FLAG_KEEP_SCREEN_ON son visibles o se mantienen los bloqueos de activación de nivel FULL_WAKE_LOCK, SCREEN_BRIGHT_WAKE_LOCK o SCREEN_DIM_WAKE_LOCK. Los bloqueos de activación con nivel PARTIAL_WAKE_LOCK no se ven afectados por esta función. Poco antes de que finalice el tiempo de espera, se puede mostrar un mensaje que advierte al usuario que el dispositivo se suspenderá si no interactúa con él.

En este contexto, la actividad del usuario hace referencia a cualquier elemento que active una llamada a PowerManager#userActivity (sin la marca USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS), incluidos, sin limitaciones, los siguientes elementos:

  • Cómo interactuar con la pantalla táctil
  • Presionar un botón físico
  • Eventos de entrada de un accesorio externo (por ejemplo, un teclado conectado, un control remoto Bluetooth o un control remoto IR)
  • Interacción de voz
  • Recibir ciertos mensajes HDMI CEC, como One Touch Play
  • Cómo iniciar una nueva sesión de transmisión

Personalización

Si la función está habilitada, el dispositivo muestra una advertencia en pantalla después de un tiempo determinado de inactividad del usuario. Si no se realiza ninguna acción, la pantalla se apagará. Puedes personalizar la función con estas opciones de configuración.

Configura el tiempo de espera

Para configurar el tiempo de espera, actualiza el siguiente elemento en frameworks/base/core/res/res/values/config.xml:

  • config_attentiveTimeout
    • Especifica el tiempo predeterminado en milisegundos de inactividad del usuario después del cual se apaga la pantalla (incluso si hay bloqueos de activación de la pantalla).
    • Se establece en el tiempo de compilación.
    • Si el valor está entre 0 y config_minimumScreenOffTimeout, el tiempo de espera se establece en config_minimumScreenOffTimeout para evitar que el dispositivo apague la pantalla poco después de activarse.
    • Valor predeterminado: -1, que inhabilita esta función.

Anula el tiempo de espera predeterminado

Para anular el parámetro de configuración de tiempo de espera predeterminado, actualiza el siguiente elemento.

  • Settings.Secure.ATTENTIVE_TIMEOUT
    • Si está establecido, anula el tiempo de espera de suspensión inatenta predeterminado que establece config_attentiveTimeout.
    • Se puede configurar en el tiempo de ejecución.

Configura la duración antes de que aparezca la advertencia

Para configurar la duración, actualiza el siguiente elemento en frameworks/base/core/res/res/values/config.xml:

  • config_attentiveWarningDuration
    • Es la cantidad de tiempo que se mostrará un mensaje de advertencia al usuario antes de que se apague la pantalla después de un período prolongado de inactividad.
    • El valor debe ser muy inferior al tiempo de espera de suspensión inatenta establecido. De lo contrario, el diálogo de advertencia se mostrará constantemente y no se podrá descartar.
    • Valor predeterminado: 30000 (30 s).

Muestra las preferencias de tiempo de espera en TvSettings

Para mostrar las preferencias de tiempo de espera, actualiza el siguiente elemento en packages/apps/TvSettings/Settings/res/values/config.xml:

  • config_show_standby_timeout
    • Indica si se debe mostrar un elemento de preferencia para permitir que se apague la pantalla durante la reproducción de contenido multimedia.
    • El valor predeterminado es false.

Recursos para la IU de advertencia

  • El diseño del cuadro de diálogo de advertencia se define en frameworks/base/packages/SystemUI/res/layout/inattentive_sleep_warning.xml.
  • Las siguientes cadenas para el diálogo se definen en frameworks/base/packages/SystemUI/res/values/strings.xml y frameworks/base/packages/SystemUI/res-product/values/strings.xml.
    • inattentive_sleep_warning_title
    • inattentive_sleep_warning_message

Las superposiciones de recursos pueden cambiar los recursos y la configuración del tiempo de compilación.

Implementación

Habilita la función con lo siguiente.

  1. Anula el config_attentiveTimeout predeterminado.
  2. Si usas el TvSettings de AOSP, haz lo siguiente:
    • Para inhabilitar la función en la configuración, anula config_show_standby_timeout.
    • Implementa tu propia configuración que establezca Settings.Secure.ATTENTIVE_TIMEOUT.

Validación

Las pruebas de CTS de la función se encuentran en cts/hostsidetests/os/src/android/os/cts/InattentiveSleepTests.java.

Ejemplos y fuente

  • frameworks/base/packages/SystemUI/src/com/android/systemui/power/InattentiveSleepWarningView.java contiene la implementación predeterminada de la IU de advertencia.
  • packages/apps/TvSettings proporciona un ejemplo de cómo exponer la función en la configuración.

Ejemplo de caso de prueba manual

  1. Asegúrate de que el parámetro de configuración para desarrolladores stay_on_while_plugged_in esté desactivado si el HAL de estado del dispositivo informa que el dispositivo tiene una batería (battery_present es true), ya que esto podría impedir que la función apague la pantalla.
    adb shell settings put global stay_on_while_plugged_in 0

  2. Establece un tiempo de espera de inactividad para que sea unos segundos más que la duración del diálogo de advertencia.
    adb shell settings put secure attentive_timeout 32000
  3. Inicia la reproducción de un video (para adquirir un bloqueo de activación de pantalla).
  4. Verifica que aparezca el diálogo de advertencia de suspensión después de unos segundos.
  5. Verifica que la pantalla se apague después de que venza el tiempo de espera establecido.