Ocultar barras de sistema para o modo imersivo

Alguns conteúdos ficam melhores em tela cheia sem indicadores na barra de status ou na barra de navegação. Alguns exemplos são vídeos, jogos, galerias de imagens, livros e slides de apresentação. Isso é chamado de modo imersivo. Esta página mostra como você pode envolver os usuários mais profundamente com conteúdo em tela cheia.

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, preste atenção à frequência com que os usuários entram e saem de apps para verificar notificações, fazer pesquisas de improviso ou realizar outras ações. Como o modo imersivo faz com que os usuários percam o acesso fácil à navegação do sistema, use o modo imersivo apenas quando o benefício para a experiência do usuário for além do simples uso de espaço extra na tela.

Use WindowInsetsControllerCompat.hide() para ocultar as barras do sistema e WindowInsetsControllerCompat.show() para mostrar de novo.

O snippet a seguir mostra um exemplo de configuração de um botão para ocultar e mostrar as barras do sistema.

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)
    }
}

@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, é possível especificar o tipo de barras do sistema a serem ocultas e determinar o comportamento delas quando um usuário interage com elas.

Especificar quais barras do sistema ocultar

Para especificar o tipo de barras do sistema a serem ocultadas, transmita um dos parâmetros a seguir para WindowInsetsControllerCompat.hide().

• Use WindowInsetsCompat.Type.systemBars() para ocultar as duas barras do sistema.

• Use WindowInsetsCompat.Type.statusBars() para ocultar apenas a barra de status.

• Use WindowInsetsCompat.Type.navigationBars() para ocultar apenas a barra de navegação.

Especificar o comportamento das barras de sistema ocultas

Use WindowInsetsControllerCompat.setSystemBarsBehavior() para especificar como as barras de sistema ocultas se comportam quando o usuário interage com elas.

• Use WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH para revelar barras do sistema ocultas em qualquer interação do usuário na tela correspondente.

• Use WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE para revelar barras do sistema ocultas em qualquer gesto do sistema, como deslizar da borda da tela em que a barra está oculta.

• Use WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE para revelar temporariamente as barras do sistema ocultas com gestos do sistema, como deslizar da borda da tela em que a barra está oculta. Essas barras de sistema temporárias sobrepõem o conteúdo do app, podem ter algum grau de transparência e são ocultadas automaticamente após um curto período.