Modalità Ambient

La modalità Ambient è un salvaschermo integrato in Google TV e Android TV. Il suo scopo è evitare di visualizzare immagini statiche per periodi prolungati. Questo è importante per le tecnologie di visualizzazione, come l'OLED, che potrebbero essere soggette a burn-in dello schermo.

Il sistema operativo mette il dispositivo in modalità Ambient dopo 10 minuti di inattività dell'utente. Dopo un ulteriore periodo di inattività dell'utente (definito dall'impostazione Risparmio energetico del dispositivo), il sistema operativo entrerà in modalità Risparmio energetico, disattivando il display. Le app di riproduzione multimediale potrebbero impedire al dispositivo di entrare in modalità Ambient, nonostante l'utente non interagisca con il dispositivo, ad esempio durante la visione di un film.

Se l'utente interagisce con il dispositivo entro 30 minuti dall'attivazione della modalità Ambient, l'app attiva al momento dell'attivazione della modalità Ambient verrà ripristinata. Se l'utente interagisce con il dispositivo più di 30 minuti dopo aver attivato la modalità Ambient, viene visualizzato nuovamente la schermata Home. Quando l'utente avvia il dispositivo utilizzando il tasto di accensione mentre è in modalità Risparmio energetico, viene visualizzata la schermata Home. In alternativa, se l'utente avvia il dispositivo in modalità Risparmio energetico utilizzando i pulsanti di app specifiche (ad esempio YouTube), verrà indirizzato direttamente a quell'app.

Riproduzione video

Per la riproduzione di video, è importante impedire al dispositivo di attivare la modalità Ambient durante la riproduzione avviata dall'utente per offrire un'esperienza di visualizzazione senza interruzioni. Tuttavia, le app non devono impedire ai dispositivi di attivare la modalità Ambient quando la riproduzione viene interrotta o messa in pausa.

Riproduzione audio

Per la riproduzione audio, le app non devono impedire la modalità Ambient durante la riproduzione a meno che non implementino un proprio salvaschermo con immagini non statiche. La riproduzione audio continuerà mentre la modalità Ambient è attiva.

La riproduzione audio su Android manterrà implicitamente un blocco risveglio parziale. In questo modo, il dispositivo non entrerà in modalità Ambient, ma impedirà la transizione successiva alla modalità Risparmio energetico. La riproduzione continuerà quindi anche dopo che il dispositivo entrerà in modalità Ambient, ma verrà impedita la sospensione del dispositivo per consentire una riproduzione ininterrotta.

Impedire l'attivazione della modalità Ambient

È possibile impedire al sistema operativo di mettere il dispositivo in modalità Ambient, ma questo deve essere utilizzato in conformità con i requisiti della modalità Ambient. Gli sviluppatori di app non possono impedire al dispositivo di attivare la modalità Risparmio energetico.

Le app possono impedire lo spegnimento dello schermo impostando un flag su Window:

Kotlin

requireActivity().window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

Java

requireActivity().getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);

La modalità Ambient verrà disattivata quando questo flag è impostato. Per riattivarlo, devi cancellare il flag:

Kotlin

requireActivity().window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)

Java

requireActivity().getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);