前言
本文總結 Android 實現沉浸式全屏的實現方式叶洞。
實現沉浸式全屏
在一些需要全屏顯示的場景下鲫凶，比如玩游戲、看橫屏視頻的時候衩辟，內容全屏螟炫，占滿窗口的體驗會讓用戶更加沉浸到對內容的消費中，帶來好的用戶體驗艺晴。
沉浸式顯示具體來說就是如狀態(tài)欄和導航欄部分的顯示效果調整不恭。當然，這里對于不同的產品形態(tài)會有不同的選擇财饥，狀態(tài)欄文本的顏色、狀態(tài)欄本身的背景色折晦、導航欄的背景色以及是否顯示钥星，通過這些組合可以呈現出不同的用戶體驗。下面就從這兩個組件的使用出發(fā)满着，看看實現沉浸式狀態(tài)欄的方法谦炒。
狀態(tài)欄
狀態(tài)欄背景色
關于狀態(tài)欄，首先是狀態(tài)欄背景色, 這個根據需要設置就好了风喇，一般情況下設置為透明比較好適配宁改。
window.statusBarColor = Color.TRANSPARENT
狀態(tài)欄文字顏色
關于狀態(tài)欄、導航欄的其他操作魂莫，我們可以使用系統(tǒng)的 WindowInsetsControllerCompat 這個類还蹲，從名字Compat 就可以看到，這是一個兼容的類耙考。關于沉浸式狀態(tài)欄的實現谜喊，由于 Android 在國內變成了「安卓」，因此早期關于狀態(tài)各種屬性的適配可以說是群魔亂舞倦始，各式各樣的 StatusBarUtils 大行其道《范簦現在好了，Android 官方終于一統(tǒng)天下鞋邑，親自下場來搞了诵次，這下關于沉浸式的實現就比較簡單了账蓉。
WindowInsetsControllerCompat 的使用也很簡單，創(chuàng)建一個他的實例即可逾一。
val controller = WindowInsetsControllerCompat(window, window.decorView)
后面的一切使用這個實例就可以了铸本，API 很簡單，命名一目了然嬉荆。
比如更改狀態(tài)顏色這個功能归敬。關于狀態(tài)欄文字的顏色，Android 官方只允許設置黑色或者白色
controller.isAppearanceLightStatusBars = true // 黑色狀態(tài)欄
// or
controller.isAppearanceLightStatusBars = false // 白色狀態(tài)欄
注意鄙早、注意汪茧、注意 ，這里的注釋沒有寫錯限番，這個方法就是這么奇怪舱污，自己一開始使用也是被繞暈了。但就是這樣弥虐。還有一點需要注意的是扩灯，Android 6.0 也就是 Android SDK 23 開始，才可以使用這個 feature 霜瘪。
狀態(tài)欄顯示與隱藏
controller.hide(WindowInsetsCompat.Type.statusBars()) // 狀態(tài)欄隱藏
// or
controller.show(WindowInsetsCompat.Type.statusBars()) // 狀態(tài)欄顯示
這個就很簡單了珠插。
導航欄
說完了狀態(tài)欄，在來看導航欄颖对。相比狀態(tài)欄捻撑，導航欄上不會有文字，一般情況下就是一條底部的橫線缤底。因此顾患，我們只需要關心導航的背景色和可見性即可。
導航欄背景色
window.navigationBarColor = Color.TRANSPARENT
導航欄橫線的顏色
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
window.navigationBarDividerColor = Color.TRANSPARENT
}
從 Android P (28) 也就是 Android 9.0 開始个唧，我們甚至可以設置導航欄橫線的顏色了江解。
潛在的坑
這里再補充一個最近遇到的關于設置狀態(tài)欄和導航欄顏色的坑。如果當前 Activity 的 theme 屬性中包含如下內容
<style name="BugTheme" parent="AppTheme">
<item name="android:windowTranslucentNavigation">true</item>
<item name="android:windowTranslucentStatus">true</item>
</style>
這里的坑就是由這個 Translucent 導致的徙歼。Translucent 的意思是半透明犁河，Transparent 的意思才是透明。這兩個單詞從拼寫到發(fā)音都有些相似鲁沥，理論上說二者的效果也是類似呼股，無非就是透明度的值不一樣而已。但就是這細微的差別画恰，容易導致問題彭谁。一旦給 Activity 的 theme 設置了如上的熟悉，那么后續(xù)通過 window.statusBarColor 和 window.navigationBarColor 設置顏色就不在生效了允扇。
導航欄顯示與隱藏
導航欄顯示與隱藏的方法缠局，和狀態(tài)欄顯示隱藏的方法非常相似则奥，改變一下參數即可。
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 读处，沉浸式就是這么簡單。
適配全面屏
從上面沉浸式的圖唱矛，可以看到其實還是有點問題罚舱，就是橫屏之后，屏幕左邊并沒有完全鋪開绎谦，而是有一段黑邊管闷，看著非常難受了。這其實是關于異形屏的適配問題窃肠。
其實這段黑邊就是劉海屏的區(qū)域包个，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
這個是默認參數纤怒。
豎屏狀態(tài)
如果沒有設置全屏顯示的屬性糯而，那么內容是延伸到 DisplayCutout area 的。這種情況下泊窘，如果進行全屏和非全屏的切換操作歧蒋，會發(fā)現內容在整體上下跳動。比如在這種情況下州既，調用 controller.hide(WindowInsetsCompat.Type.statusBars()) 進行狀態(tài)欄的操作，就會發(fā)現整個內容在上下跳動萝映。在上面的動圖里很明顯了吴叶。
橫屏狀態(tài)
橫屏狀態(tài)下，頂部的狀態(tài)欄就變成左邊或者右邊（這里看屏幕是怎么旋轉的序臂，可能是旋轉了 -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 的區(qū)別审胸，我們用兩張圖比較一下就大概明白了。
| 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 模式下砂沛，整個內容都撐開到劉海的區(qū)域了。屏占比更高了曙求，看著也更舒服了碍庵。
總結
使用官方提供的 WindowInsetsControllerCompat 的系列 API，操作狀態(tài)欄及導航欄悟狱，以及沉浸式的實現相對來說比較簡單了静浴，底層處理了各個版本之間的兼容性。
