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

일부 콘텐츠는 탐색 메뉴를 엽니다. 예로는 동영상, 게임, 이미지 등이 갤러리, 도서, 프리젠테이션 슬라이드가 있어야 합니다. 이를 가리켜 몰입형 모드입니다. 이 페이지에서는 새로운 소셜 미디어 캠페인을 사용해 표시할 수 있습니다.

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