Alguns conteúdos têm melhor experiência em tela cheia sem indicadores no na barra de status ou na barra de navegação. Alguns exemplos são vídeos, jogos, imagens galerias, livros e slides de apresentações. Isso é chamado de modo imersivo. Esta página mostra como você pode envolver mais profundamente os usuários com conteúdo em tela cheia.
![](https://developer.android.com/static/design/media/fullscreen_landing.png?authuser=9&hl=pt)
O modo imersivo ajuda os usuários a evitar saídas acidentais durante um jogo e oferece uma experiência imersiva para curtir imagens, vídeos e livros. No entanto, considere a frequência com que os usuários entram e saem dos apps para conferir as notificações, para realizar pesquisas improvisadas ou outras ações. Como o modo imersivo faz com que os usuários percam o acesso fácil à navegação do sistema, usem apenas o modo imersivo quando o benefício para a experiência do usuário vai além do simples uso da tela extra espaço.
Usar WindowInsetsControllerCompat.hide()
para ocultar as barras de sistema e WindowInsetsControllerCompat.show()
para trazê-los de volta.
O snippet a seguir mostra um exemplo de como configurar um botão para ocultar e mostrar das barras do sistema.
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { ... val windowInsetsController = WindowCompat.getInsetsController(window, window.decorView) // Configure the behavior of the hidden system bars. windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE // Add a listener to update the behavior of the toggle fullscreen button when // the system bars are hidden or revealed. ViewCompat.setOnApplyWindowInsetsListener(window.decorView) { view, windowInsets -> // You can hide the caption bar even when the other system bars are visible. // To account for this, explicitly check the visibility of navigationBars() // and statusBars() rather than checking the visibility of systemBars(). if (windowInsets.isVisible(WindowInsetsCompat.Type.navigationBars()) || windowInsets.isVisible(WindowInsetsCompat.Type.statusBars())) { binding.toggleFullscreenButton.setOnClickListener { // Hide both the status bar and the navigation bar. windowInsetsController.hide(WindowInsetsCompat.Type.systemBars()) } } else { binding.toggleFullscreenButton.setOnClickListener { // Show both the status bar and the navigation bar. windowInsetsController.show(WindowInsetsCompat.Type.systemBars()) } } ViewCompat.onApplyWindowInsets(view, windowInsets) } }
Java
@Override protected void onCreate(Bundle savedInstanceState) { ... WindowInsetsControllerCompat windowInsetsController = WindowCompat.getInsetsController(getWindow(), getWindow().getDecorView()); // Configure the behavior of the hidden system bars. windowInsetsController.setSystemBarsBehavior( WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE ); // Add a listener to update the behavior of the toggle fullscreen button when // the system bars are hidden or revealed. ViewCompat.setOnApplyWindowInsetsListener( getWindow().getDecorView(), (view, windowInsets) -> { // You can hide the caption bar even when the other system bars are visible. // To account for this, explicitly check the visibility of navigationBars() // and statusBars() rather than checking the visibility of systemBars(). if (windowInsets.isVisible(WindowInsetsCompat.Type.navigationBars()) || windowInsets.isVisible(WindowInsetsCompat.Type.statusBars())) { binding.toggleFullscreenButton.setOnClickListener(v -> { // Hide both the status bar and the navigation bar. windowInsetsController.hide(WindowInsetsCompat.Type.systemBars()); }); } else { binding.toggleFullscreenButton.setOnClickListener(v -> { // Show both the status bar and the navigation bar. windowInsetsController.show(WindowInsetsCompat.Type.systemBars()); }); } return ViewCompat.onApplyWindowInsets(view, windowInsets); }); }
Opcionalmente, você pode especificar o tipo de barras de sistema para ocultar e determinar seu comportamento quando um usuário interage com elas.
Especificar quais barras de sistema serão ocultadas
Para especificar o tipo de barras de sistema a serem ocultadas, transmita um dos seguintes parâmetros
para WindowInsetsControllerCompat.hide()
.
Use
WindowInsetsCompat.Type.systemBars()
para ocultar as duas barras de sistema.Use
WindowInsetsCompat.Type.statusBars()
para ocultar apenas a barra de status.Use
WindowInsetsCompat.Type.navigationBars()
para apenas a barra de navegação.
Especificar o comportamento de barras de sistema ocultas
Usar WindowInsetsControllerCompat.setSystemBarsBehavior()
para especificar como as barras de sistema ocultas se comportam quando o usuário interage com elas.
Usar
WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH
para revelar barras de sistema ocultas em qualquer interação do usuário no exibição.Usar
WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE
para revelar barras ocultas em qualquer gesto do sistema, como deslizar de a borda da tela, de onde a barra está oculta.Usar
WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
para revelar temporariamente barras de sistema ocultas com gestos do sistema, como deslizando a partir da borda da tela em que a barra está oculta. Esses as barras temporárias do sistema se sobrepõem ao conteúdo do app, podendo ter transparência e são automaticamente ocultados após um curto tempo limite.