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

일부 콘텐츠는 화면에 표시가 없는 경우 전체 화면에서 가장 잘 나타납니다. 탐색 메뉴를 엽니다. 동영상, 게임, 이미지 갤러리, 책, 프레젠테이션 슬라이드 등이 여기에 해당합니다. 이를 몰입형 모드라고 합니다. 이 페이지에서는 전체 화면에서 사용자를 콘텐츠에 더욱 몰입하게 하는 방법을 설명합니다.

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

자바

@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() 사용 를 사용하여 숨겨진 시스템 표시줄과 상호작용할 때 숨겨진 시스템 표시줄의 동작을 지정할 수 있습니다.