Ukryj paski systemowe w trybie pojemnym

Niektóre treści najlepiej wyświetlać na pełnym ekranie bez żadnych wskaźników na pasku stanu lub pasku nawigacyjnym. Przykłady to filmy, gry, galerie zdjęć, książki i slajdy prezentacji. Nazywa się to trybem pełnoekranowym. Na tej stronie dowiesz się, jak zwiększyć zaangażowanie użytkowników w treści wyświetlane na pełnym ekranie.

Rysunek 1. Przykład trybu imersji.

Tryb pełnoekranowy pomaga użytkownikom uniknąć przypadkowego wyjścia z gry i zapewnia wciągające wrażenia podczas oglądania zdjęć i filmów oraz czytania książek. Pamiętaj jednak, jak często użytkownicy wchodzą do aplikacji i z niej wychodzą, aby sprawdzić powiadomienia, przeprowadzić doraźne wyszukiwanie lub wykonać inne działania. Tryb pełnoekranowy powoduje, że użytkownicy tracą łatwy dostęp do nawigacji systemowej, dlatego należy go używać tylko wtedy, gdy korzyści dla wrażeń użytkownika wykraczają poza zwykłe wykorzystanie dodatkowej przestrzeni ekranu.

Użyj WindowInsetsControllerCompat.hide(), aby ukryć paski systemowe, i WindowInsetsControllerCompat.show(), aby je przywrócić.

Poniższy fragment kodu pokazuje przykład konfiguracji przycisku, który będzie ukrywać i wyświetlać paski systemowe.

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

Opcjonalnie możesz określić typ pasków systemowych do ukrycia i ustalić ich zachowanie, gdy użytkownik wejdzie z nimi w interakcję.

Określanie, które paski systemowe mają być ukryte

Aby określić typ pasków systemowych do ukrycia, przekaż jeden z tych parametrów do funkcji WindowInsetsControllerCompat.hide().

Określanie zachowania ukrytych pasków systemowych

Użyj WindowInsetsControllerCompat.setSystemBarsBehavior(), aby określić, jak ukryte paski systemowe mają się zachowywać, gdy użytkownik wchodzi z nimi w interakcję.