Android 实现沉浸式全屏

前言

本文总结 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 // 白色状态栏

注意、注意、注意 ，这里的注释没有写错，这个方法就是这么奇怪ÿ