Modalità Ambient

La modalità Ambient è un salvaschermo integrato in Google TV e Android TV. Il suo scopo è evitare di mostrare immagini statiche per periodi prolungati. È importante per le tecnologie di visualizzazione, come gli OLED, che possono essere soggetti a bruciature sullo schermo.

Il sistema operativo attiva la modalità Ambient sul dispositivo dopo 10 minuti di utilizzo di inattività. Dopo un ulteriore periodo di inattività dell'utente (definito dal dispositivo) Risparmio energetico, il sistema operativo entrerà in modalità Risparmio energetico, spegnendo il display. Le app di riproduzione di contenuti multimediali potrebbero impedire al dispositivo di attivare la modalità Ambient, nonostante l'utente non interagisca con quest'ultima, per ad esempio durante la visione di un film.

Se l'utente interagisce con il dispositivo entro 30 minuti dall'attivazione della modalità Ambient Modalità Ambient, verrà ripristinata l'app che era attiva quando era stata attivata la modalità Ambient. Se l'utente interagisce con il dispositivo più di 30 minuti dopo l'ingresso in modalità Ambient, torneranno alla schermata Home. Quando l'utente avvia il dispositivo usando il tasto di accensione mentre è in modalità Energia. modalità Risparmio, verrà visualizzata la schermata Home. In alternativa, se l'utente avvia il dispositivo mentre è in modalità Risparmio energetico usando pulsanti specifici dell'app (ad esempio, YouTube) saranno indirizzati direttamente a quell'app.

Se utilizzi MediaSession per la riproduzione di contenuti multimediali, conterrà una traccia Wakelock parziale quando si avvia la riproduzione. Mettendo in pausa la riproduzione non rilascerai questo wakelock. Ciò significa che il dispositivo potrebbe attivare automaticamente la modalità Ambient, ma non successivamente attivare la modalità Risparmio energetico. Se l'utente interagisce con il dispositivo entro 30 minuti dall'attivazione della modalità Ambient, la tua app verrà ripristinata.

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 visione ininterrotta. Tuttavia, le app non Impedisce 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 deve impedire la modalità Ambient durante la riproduzione a meno che non implementino un proprio salvaschermo con immagini non statiche. La riproduzione dell'audio continuerà mentre è attiva la modalità Ambient.

La riproduzione audio su Android contiene implicitamente un wakelock parziale. Ciò non impedirà al dispositivo di attivare la modalità Ambient, ma impedire la successiva transizione alla modalità di risparmio energetico. Pertanto, la riproduzione continuerà anche dopo l'attivazione della modalità Ambient, ma il dispositivo non sia possibile andare in modalità di sospensione per consentire una riproduzione ininterrotta.

Impedire la modalità Ambient

È possibile impedire al sistema operativo di attivare la modalità Ambient sul dispositivo, ma questo deve essere utilizzato in conformità con Requisiti della modalità Ambient. Gli sviluppatori di app non possono impedire l'accesso al dispositivo Modalità Risparmio energetico.

Le app possono impedire la disattivazione dello schermo impostando un flag sulla 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 mentre questo flag è impostato. Per riattivarla, devi cancella la segnalazione:

Kotlin

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

Java

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