前言
本文總結 Android 實現沉浸式全屏的實現方式。
實現沉浸式全屏
在一些需要全屏顯示的場景下，比如玩游戲、看橫屏視頻的時候，內容全屏，占滿窗口的體驗會讓用戶更加沉浸到對內容的消費中，帶來好的用戶體驗。
沉浸式顯示具體來說就是如狀態欄和導航欄部分的顯示效果調整。當然，這里對于不同的產品形態會有不同的選擇，狀態欄文本的顏色、狀態欄本身的背景色、導航欄的背景色以及是否顯示，通過這些組合可以呈現出不同的用戶體驗。下面就從這兩個組件的使用出發，看看實現沉浸式狀態欄的方法。
狀態欄
狀態欄背景色
關于狀態欄，首先是狀態欄背景色, 這個根據需要設置就好了，一般情況下設置為透明比較好適配。
window.statusBarColor = Color.TRANSPARENT
狀態欄文字顏色
關于狀態欄、導航欄的其他操作，我們可以使用系統的 WindowInsetsControllerCompat 這個類，從名字Compat 就可以看到，這是一個兼容的類。關于沉浸式狀態欄的實現，由于 Android 在國內變成了「安卓」，因此早期關于狀態各種屬性的適配可以說是群魔亂舞，各式各樣的 StatusBarUtils 大行其道。現在好了，Android 官方終于一統天下，親自下場來搞了，這下關于沉浸式的實現就比較簡單了。
WindowInsetsControllerCompat 的使用也很簡單，創建一個他的實例即可。
val controller = WindowInsetsControllerCompat(window, window.decorView)
后面的一切使用這個實例就可以了，API 很簡單，命名一目了然。
比如更改狀態顏色這個功能。關于狀態欄文字的顏色，Android 官方只允許設置黑色或者白色
controller.isAppearanceLightStatusBars = true // 黑色狀態欄
// or
controller.isAppearanceLightStatusBars = false // 白色狀態欄
注意、注意、注意 ，這里的注釋沒有寫錯，這個方法就是這么奇怪，自己一開始使用也是被繞暈了。但就是這樣。還有一點需要注意的是，Android 6.0 也就是 Android SDK 23 開始，才可以使用這個 feature 。
狀態欄顯示與隱藏
controller.hide(WindowInsetsCompat.Type.statusBars()) // 狀態欄隱藏
// or
controller.show(WindowInsetsCompat.Type.statusBars()) // 狀態欄顯示
這個就很簡單了。
導航欄
說完了狀態欄，在來看導航欄。相比狀態欄，導航欄上不會有文字，一般情況下就是一條底部的橫線。因此，我們只需要關心導航的背景色和可見性即可。
導航欄背景色
window.navigationBarColor = Color.TRANSPARENT
導航欄橫線的顏色
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
window.navigationBarDividerColor = Color.TRANSPARENT
}
從 Android P (28) 也就是 Android 9.0 開始，我們甚至可以設置導航欄橫線的顏色了。
潛在的坑
這里再補充一個最近遇到的關于設置狀態欄和導航欄顏色的坑。如果當前 Activity 的 theme 屬性中包含如下內容
<style name="BugTheme" parent="AppTheme">
<item name="android:windowTranslucentNavigation">true</item>
<item name="android:windowTranslucentStatus">true</item>
</style>
這里的坑就是由這個 Translucent 導致的。Translucent 的意思是半透明，Transparent 的意思才是透明。這兩個單詞從拼寫到發音都有些相似，理論上說二者的效果也是類似，無非就是透明度的值不一樣而已。但就是這細微的差別，容易導致問題。一旦給 Activity 的 theme 設置了如上的熟悉，那么后續通過 window.statusBarColor 和 window.navigationBarColor 設置顏色就不在生效了。
導航欄顯示與隱藏
導航欄顯示與隱藏的方法，和狀態欄顯示隱藏的方法非常相似，改變一下參數即可。
controller.hide(WindowInsetsCompat.Type.navigationBars()) // 導航欄隱藏
// or
controller.show(WindowInsetsCompat.Type.navigationBars()) // 導航欄顯示
沉浸式
WindowCompat.setDecorFitsSystemWindows(window, false) // 打開沉浸式
// or
WindowCompat.setDecorFitsSystemWindows(window, true) // 關閉沉浸式
| 沉浸式開 | 沉浸式關閉 |
|---|---|
 full_off.png
|
 full_on.png
|
可以看到，使用 WindowInsetsControllerCompat ，沉浸式就是這么簡單。
適配全面屏
從上面沉浸式的圖，可以看到其實還是有點問題，就是橫屏之后，屏幕左邊并沒有完全鋪開，而是有一段黑邊，看著非常難受了。這其實是關于異形屏的適配問題。
其實這段黑邊就是劉海屏的區域，Android 官方叫做 DisplayCutout area
val params = window.attributes
params.layoutInDisplayCutoutMode =
WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
window.attributes = params
大于等于 Android 9.0 （SDK 28 P）的設備都支持。關于 layoutInDisplayCutoutMode 參數有三種類型。
關于這三個參數，還要考慮當前屏幕是橫屏還是豎屏。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT
這個是默認參數。
豎屏狀態
如果沒有設置全屏顯示的屬性，那么內容是延伸到 DisplayCutout area 的。這種情況下，如果進行全屏和非全屏的切換操作，會發現內容在整體上下跳動。比如在這種情況下，調用 controller.hide(WindowInsetsCompat.Type.statusBars()) 進行狀態欄的操作，就會發現整個內容在上下跳動。在上面的動圖里很明顯了。
橫屏狀態
橫屏狀態下，頂部的狀態欄就變成左邊或者右邊（這里看屏幕是怎么旋轉的，可能是旋轉了 -90 度，也可能是 270 度）的黑邊了。內容不會延伸到左右兩邊的 DisplayCutout area 里。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
這種情況下，內容是默認延伸到 DisplayCutout area 的。因此，全屏和非全屏操作的時候，就不會有內容上下跳動或者屏幕上說的問題。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER
這種情況，內容永遠不會延伸到 DisplayCutout area 里面。
關于 LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT 和 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 的區別，我們用兩張圖比較一下就大概明白了。
| LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT | LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES |
|---|---|
full_on.png
|
 full_full.png
|
可以看到，LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES 模式下，整個內容都撐開到劉海的區域了。屏占比更高了，看著也更舒服了。
總結
使用官方提供的 WindowInsetsControllerCompat 的系列 API，操作狀態欄及導航欄，以及沉浸式的實現相對來說比較簡單了，底層處理了各個版本之間的兼容性。
