某些内容最好在全屏模式下体验,且不显示状态栏或导航栏中的任何指示器。例如视频、游戏、图片库、图书和演示文稿幻灯片。这称为 沉浸模式。此页面演示了如何在全屏模式下通过内容更深入地吸引用户。

沉浸模式有助于用户避免在游戏过程中意外退出,并为欣赏图片、视频和图书提供沉浸式体验。但是,请注意用户检查通知、进行即时搜索或执行其他操作时进出应用的频率。由于沉浸模式导致用户无法轻松访问系统导航,因此仅当对用户体验的益处超出单纯利用更多屏幕空间时,才使用沉浸模式。
使用 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()
。
使用
WindowInsetsCompat.Type.systemBars()
隐藏两个系统栏。使用
WindowInsetsCompat.Type.statusBars()
仅隐藏状态栏。使用
WindowInsetsCompat.Type.navigationBars()
仅隐藏导航栏。
指定隐藏系统栏的行为
使用 WindowInsetsControllerCompat.setSystemBarsBehavior()
指定隐藏的系统栏在用户与其互动时的行为。
使用
WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH
可在相应显示屏上的任何用户交互时显示隐藏的系统栏。使用
WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE
可在任何系统手势时(例如从隐藏系统栏的屏幕边缘滑动时)显示隐藏的系统栏。使用
WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
可在系统手势时暂时显示隐藏的系统栏,例如从隐藏系统栏的屏幕边缘滑动时。这些短暂的系统栏会覆盖应用内容,可能具有一定透明度,并在短暂超时后自动隐藏。