몰입형 모드를 위한 시스템 표시줄 숨기기

일부 콘텐츠는 상태 표시줄이나 탐색 메뉴에 표시가 없는 전체 화면에서 가장 잘 나타납니다. 동영상, 게임, 이미지 갤러리, 도서, 프레젠테이션 슬라이드 등을 예로 들 수 있습니다 이를 몰입형 모드라고 합니다. 이 페이지에서는 전체 화면에서 콘텐츠에 대해 사용자의 참여도를 높이는 방법을 보여줍니다.

그림 1. 몰입형 모드의 예

몰입형 모드는 사용자가 게임 중에 실수로 종료되는 일을 방지하고 이미지, 동영상, 도서를 즐길 수 있는 몰입형 환경을 제공합니다. 하지만 사용자가 알림을 확인하거나, 즉흥적인 검색을 하거나, 기타 작업을 수행하기 위해 얼마나 자주 앱을 시작하고 종료하는지 고려해야 합니다. 몰입형 모드에서는 사용자가 시스템 탐색에 쉽게 액세스할 수 없으므로 몰입형 모드는 단순한 추가 화면 공간 사용 이상의 이점이 사용자 환경에 미치는 경우에만 사용하세요.

WindowInsetsControllerCompat.hide()를 사용하여 시스템 표시줄을 숨기고 WindowInsetsControllerCompat.show()를 사용하여 다시 표시합니다.

다음 스니펫은 시스템 표시줄을 숨기거나 표시하도록 버튼을 구성하는 예를 보여줍니다.

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

선택적으로, 사용자가 시스템 표시줄과 상호작용할 때 숨기고 동작을 결정할 시스템 표시줄 유형을 지정할 수 있습니다.

숨길 시스템 표시줄 지정

숨길 시스템 표시줄 유형을 지정하려면 다음 매개변수 중 하나를 WindowInsetsControllerCompat.hide()에 전달합니다.

숨겨진 시스템 표시줄의 동작 지정

WindowInsetsControllerCompat.setSystemBarsBehavior()를 사용하여 사용자가 숨겨진 시스템 표시줄과 상호작용할 때 숨겨진 시스템 표시줄의 동작을 지정합니다.