某些內容在全螢幕模式下才能獲得最佳效果,而且不會在狀態列或導覽列上顯示任何指標。例如影片、遊戲、圖像、書籍和簡報投影片這稱為「沉浸模式」。本頁說明如何與全螢幕內容進行更深入的互動。
沉浸模式可協助使用者在遊戲中避免意外退出,提供沉浸式體驗,盡情享受圖片、影片和書籍的樂趣。不過,請留意使用者進入/離開應用程式查看通知的頻率、執行臨時搜尋或採取其他動作的頻率。由於沉浸模式會讓使用者無法輕鬆存取系統導覽,因此除非只有使用額外的螢幕空間,才有利於使用者體驗,否則才使用沉浸模式。
使用 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
,即可透過系統手勢暫時顯示隱藏的系統資訊列,例如從螢幕邊緣隱藏長條的邊緣滑動。這些暫時性的系統資訊列會重疊顯示在應用程式內容上,而且可能有一定程度的透明度,且會在短暫逾時後自動隱藏。