Veille TV

Dans Android 11, le mode veille inattentive est une fonctionnalité d'économie d'énergie qui permet de définir un délai d'inactivité de l'utilisateur au bout duquel l'écran s'éteint, même si des fenêtres avec FLAG_KEEP_SCREEN_ON sont visibles ou que des wakelocks de niveau FULL_WAKE_LOCK, SCREEN_BRIGHT_WAKE_LOCK ou SCREEN_DIM_WAKE_LOCK sont maintenus. Les wakelocks de niveau PARTIAL_WAKE_LOCK ne sont pas affectés par cette fonctionnalité. Peu de temps avant l'expiration du délai avant expiration, un message peut s'afficher pour avertir l'utilisateur que l'appareil se met en veille s'il n'interagit pas avec lui.

Dans ce contexte, l'activité de l'utilisateur désigne tout ce qui déclenche un appel à PowerManager#userActivity (sans l'indicateur USER_ACTIVITY_FLAG_NO_CHANGE_LIGHTS), y compris, mais sans s'y limiter:

  • Interagir avec l'écran tactile
  • Appuyer sur un bouton physique
  • Événements d'entrée provenant d'un accessoire externe (par exemple, clavier connecté, télécommande Bluetooth, télécommande infrarouge)
  • Interaction vocale
  • Réception de certains messages HDMI CEC, tels que One Touch Play
  • Démarrer une session de diffusion

Personnalisation

Si la fonctionnalité est activée, un avertissement s'affiche à l'écran après un délai d'inactivité spécifié. Si aucune action n'est effectuée, l'écran s'éteint. Vous pouvez personnaliser cette fonctionnalité à l'aide de ces options de configuration.

Configurer le délai avant expiration

Pour configurer le délai avant expiration, mettez à jour l'élément suivant dans frameworks/base/core/res/res/values/config.xml:

  • config_attentiveTimeout
    • Spécifie le délai par défaut, en millisecondes, d'inactivité de l'utilisateur au terme duquel l'écran s'éteint (même si des wakelocks sont en place).
    • Défini à l'heure de compilation.
    • Si la valeur est comprise entre 0 et config_minimumScreenOffTimeout, le délai avant expiration est défini sur config_minimumScreenOffTimeout pour empêcher l'appareil d'éteindre son écran peu de temps après son réveil.
    • Valeur par défaut: -1, ce qui désactive cette fonctionnalité.

Ignorer le délai avant expiration par défaut

Pour remplacer le paramètre de délai avant expiration par défaut, mettez à jour l'élément suivant.

  • Settings.Secure.ATTENTIVE_TIMEOUT
    • Si cette valeur est définie, elle remplace le délai avant expiration du sommeil inattentif par défaut défini par config_attentiveTimeout.
    • Peut être défini au moment de l'exécution.

Configurer la durée avant l'affichage de l'avertissement

Pour configurer la durée, mettez à jour l'élément suivant dans frameworks/base/core/res/res/values/config.xml:

  • config_attentiveWarningDuration
    • Délai d'affichage d'un message d'avertissement avant que l'écran ne s'éteigne après une inactivité prolongée de l'utilisateur.
    • La valeur doit être bien inférieure au délai avant expiration de la mise en veille inattentive défini, sinon la boîte de dialogue d'avertissement s'affiche en permanence et ne peut pas être fermée.
    • Valeur par défaut: 30000 (30 s).

Afficher les préférences de délai avant expiration dans TvSettings

Pour afficher les préférences de délai avant expiration, mettez à jour l'élément suivant dans packages/apps/TvSettings/Settings/res/values/config.xml:

  • config_show_standby_timeout
    • Indique si un élément de préférence doit être affiché pour autoriser l'extinction de l'écran pendant la lecture multimédia.
    • Valeur par défaut: false.

Ressources pour l'UI d'avertissement

  • La mise en page de la boîte de dialogue d'avertissement est définie dans frameworks/base/packages/SystemUI/res/layout/inattentive_sleep_warning.xml.
  • Les chaînes suivantes de la boîte de dialogue sont définies dans frameworks/base/packages/SystemUI/res/values/strings.xml et frameworks/base/packages/SystemUI/res-product/values/strings.xml.
    • inattentive_sleep_warning_title
    • inattentive_sleep_warning_message

Les ressources et les configurations de la date de compilation peuvent être modifiées par les superpositions de ressources.

Implémentation

Activez la fonctionnalité à l'aide des éléments suivants.

  1. Ignorer le config_attentiveTimeout par défaut.
  2. Si vous utilisez l'TvSettings AOSP:
    • Désactivez la fonctionnalité dans les paramètres en remplaçant config_show_standby_timeout.
    • Implémentez vos propres paramètres qui définissent Settings.Secure.ATTENTIVE_TIMEOUT.

Validation

Les tests CTS de la fonctionnalité sont disponibles à l'adresse cts/hostsidetests/os/src/android/os/cts/InattentiveSleepTests.java.

Exemples et source

  • frameworks/base/packages/SystemUI/src/com/android/systemui/power/InattentiveSleepWarningView.java contient l'implémentation de l'interface utilisateur d'avertissement par défaut.
  • packages/apps/TvSettings fournit un exemple d'exposition de la fonctionnalité dans les paramètres.

Exemple de scénario de test manuel

  1. Assurez-vous que le paramètre stay_on_while_plugged_in pour les développeurs est désactivé si le HAL de l'appareil indique que celui-ci est équipé d'une batterie (battery_present est défini sur true), car cela pourrait empêcher la fonctionnalité de désactiver l'écran.
    adb shell settings put global stay_on_while_plugged_in 0

  2. Définissez le délai avant expiration de la mise en veille en cas d'inattention sur quelques secondes de plus que la durée de la boîte de dialogue d'avertissement.
    adb shell settings put secure attentive_timeout 32000
  3. Lancez la lecture d'une vidéo (pour acquérir un wakelock d'écran).
  4. Vérifiez que la boîte de dialogue d'avertissement de mise en veille s'affiche après quelques secondes.
  5. Vérifiez que l'écran s'éteint après expiration du délai défini.