UI篇Android 沉浸式状态栏的那些事

此篇文章介绍的内容都是考虑到5.0 版本以上。5.0以下的不做介绍。演示的代码皆为kotlin实现
首先一般设置是包括两方面的，第一是设置 window.decorView.systemUiVisibility ，第二是设置 window.addFlags() 这些方法都有一些常量的设置。但是在API 30 版本之后又新出了一个 WindowInsetsControllerCompat 的类，用来提供一个统一的一些操作。

window.decorView.systemUiVisibility 的参数常量

参考： 传送门
能够造成SystemUI Flag被系统自动清除的交互分类

• 1、触摸屏幕任何位置
• 2、顶部下拉状态栏
• 3、底部上拉导航栏
• 4、Window的变化(如：跳转到其他界面、弹出键盘等)

1.View.SYSTEM_UI_FLAG_HIDE_NAVIGATION：(>=api16)

作用是隐藏系统NavigationBar。
但是用户的任何交互，都会导致此Flag被系统清除，进而导航栏自动重新显示，同时View.SYSTEM_UI_FLAG_FULLSCREEN也会被自动清除，因此StatusBar也会同时显示出来。

2.View.SYSTEM_UI_FLAG_FULLSCREEN：(>=api16)

作用是隐藏StatusBar。
和WindowManager.LayoutParams.FLAG_FULLSCREEN有相同视觉效果。不同在于，此Flag一般用在暂时需要全屏的情形（如：阅读应用，全屏视频等），以便让用户的注意力暂时集中在内容上，而如果只是简单的需要一直停留在全屏状态（如：游戏应用），使用WindowManager.LayoutParams.FLAG_FULLSCREEN则是更好的选择。
此Flag会因为各种的交互（如：跳转到其他应用,下拉StatusBar，弹出键盘）的发送而被系统清除。

3.View.SYSTEM_UI_FLAG_IMMERSIVE：(>=api19)

作用:避免某些用户交互造成系统自动清除全屏状态。

• 1、View.SYSTEM_UI_FLAG_IMMERSIVE和View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY的使用主要是为了当设置全屏模式时，避免某些用户交互造成系统自动清除全屏状态。
• 2、当使用View.SYSTEM_UI_FLAG_HIDE_NAVIGATION隐藏导航栏时，配合此特性，只有第三、四种操作会导致导航栏的隐藏状态被系统自动清除；否则，任何交互都会导致导航栏的隐藏状态被系统自动清除。
• 3、此标识只有配合View.SYSTEM_UI_FLAG_HIDE_NAVIGATION才有作用。

4.View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY：(>=api19)

作用:避免某些用户交互造成系统自动清除全屏状态。同时Activity的部分内容也因此被StatusBar覆盖遮挡。

• 1、用View.SYSTEM_UI_FLAG_HIDE_NAVIGATION隐藏导航栏，配合使用此Flag,只有用户的第四种操作会导致状态栏或（和）导航栏的隐藏状态被系统自动清除。否则任何交互都会导致相应状态的清除。
• 2、此Flag只有配合SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION使用时才会起作用。

5.View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION：(>=api16)

作用:在不隐藏导航栏的情况下，将Activity的显示范围扩展到导航栏底部。同时Activity的部分内容也因此被NavigationBar覆盖遮挡。

• 1、当使用此Flag时，设置fitSystemWindow=true的view，会被系统自动添加大小为NavigationBar高度相同的paddingBottom。
• 2、当window设置WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION时，此Flag会被系统会自动添加。

6.View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN：(>=api16)

作用：在不隐藏StatusBar的情况下，将view所在window的显示范围扩展到StatusBar下面。同时Activity的部分内容也因此被StatusBar覆盖遮挡。

• 1、当使用此Flag时，设置fitSystemWindow=true的view，会被系统自动添加大小为statusBar和ActionBar高度之和相同的paddingTop。
• 2、当window设置WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS时，此Flag会被系统会自动添加。

7.View.SYSTEM_UI_FLAG_LAYOUT_STABLE:

作用: 稳定布局。当StatusBar和NavigationBar动态显示和隐藏时，系统为fitSystemWindow=true的view设置的padding大小都不会变化，所以view的内容的位置也不会发生移动。

• 1、当使用SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN或SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION)，同时view设置fitSystemWindow=true时，系统会为此View自动设置padding。此padding的大小由View.fitSystemWindows(Rect)的Rect提供。一般情况下，当StatusBar和NavigationBar显示时，paddingTop的大小为StatusBar的高度。如果设置了getWindow().requestFeature(Window.FEATURE_ACTION_BAR_OVERLAY),paddingTop的大小则为StatusBar和ActionBar的高度之和。paddingBottom的大小则为NavigationBar的高度。当StatusBar和NavigationBar被隐藏时，View的padingBottom和paddingTop的大小就变成了0, 因此StatusBar和NavigationBar的显示和隐藏造成的padding变化，进而View内容的位置变化，从而造成位置闪动的视觉效果，影响体验。
  使用SYSTEM_UI_FLAG_LAYOUT_STABLE的作用便是当StatusBar和NavigationBar的显示和隐藏，系统为View设置的padding都不会变化，因此View内容的位置不会变化，此即为稳定布局。
  -. （SYSTEM_UI_FLAG_FULLSCREEN |SYSTEM_UI_FLAG_LAYOUT_STABLE）时，
  会同时隐藏Actionbar和StatusBar，但StatusBar所占空间不会隐藏，只会变成空白。同时View所在window的显示范围也不会伸展到StatusBar所占空间。若是加上SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，View所在window的显示范围则会伸展到StatusBar所在的空间。
  同样对NavigationBar如此操作，也会是一样的效果。
• 2、当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN时，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN，不会因为StatusBar的显示或隐藏不会造成内容view的不稳定。
• 3、当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION，不会因为StatusBar和导航栏的显示或隐藏不会造成内容view的不稳定。
• 4、此特性不应该只配合SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION使用
• 5、使用WindowManager.LayoutParams.FLAG_FULLSCREEN（而不是使用SYSTEM_UI_FLAG_FULLSCREEN）来隐藏StatusBar是一个一直持续隐藏的状态。这时你仍然可以使用SYSTEM_UI_FLAG_FULLSCREEN | SYSTEM_UI_FLAG_LAYOUT_STABLE隐藏Actionbar，并且不会因为ActionBar的显示或隐藏而不稳定。

window.addFlags()的常量参数

1.WindowMananger.FLAG_TRANSLUCENT_STATUS： (>=api16)

• 1、半透明StatusBar,并且不会因用户交互而被清除。
• 2、设置了此flag,系统会自动设置View.SYSTEM_UI_FLAG_LAYOUT_STABLE和View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

2.WindowMananger.FLAG_FULLSCREEN：

• 1、用于隐藏StatusBar。隐藏效果不会被清除。
• 2、使用此flag,系统会自动忽略输入法的SOFT_INPUT_ADJUST_RESIZE的特性。

3.WindowMananger.FLAG_TRANSLUCENT_NAVIGATION：

• 1.半透明NavigationBar,并且不会因用户交互而被清除。
• 2.设置了此flag,系统会自动设置View.SYSTEM_UI_FLAG_LAYOUT_STABLE和View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
  最低版本支持：Android4.4 (api 19)

4.WindowMananger.FLAG_DRAWS_SYSTEM_BAR_BACKGROUND：

• 1.用于未StatusBar和NavigationBar设置背景颜色。
• 2.原理：将StatusBar和NavigationBar设置为透明背景，并且将StatusBar和NavigationBar所在空间设置为Window.getStatusBarColor() 和Window.getNavigationBarColor()方法获得的颜色。
  最低版本支持：Android5.0 (api 21)

WindowInsetsControllerCompat 类

上面的参数常量，大部分都会提示已经过期了，因为在API 30 版本里面出了WindowInsetsControllerCompat 的一个新类。
比如 View.SYSTEM_UI_FLAG_FULLSCREEN 以及 WindowManager.LayoutParams.FLAG_FULLSCREEN 常量点进去都会提示使用：

• @deprecated Use {@link WindowInsetsController#hide(int)} with {@link Type#statusBars()}

但是以上两个常量的作用并不一样。 View.SYSTEM_UI_FLAG_FULLSCREEN 的隐藏作用在下拉状态栏之后就会取消隐藏。需要搭配 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 来位置隐藏的效果。 而查看 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 源码又会提示使用：

• @deprecated Use {@link WindowInsetsController#BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE} instead.

经过验证也得出 WindowInsetsController#hide(int) 方法的隐藏会被下拉状态栏操作取消。需要设置 controller.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE 来维持隐藏的状态。

实现需求和方式

隐藏状态栏（全屏显示）

隐藏状态栏分两种情况，一个是在非刘海屏或挖孔屏，也就是正常的直面屏上。

• 1、直接隐藏状态栏，且状态栏可下拉出来，下来出来的状态栏是半透明的，但是一会后状态栏还是会自动缩回去。下面三种实现方式同效果。（这种方式在刘海屏中会导致有刘海的状态栏直接置黑，且显示内容是不会上移到状态栏处）

<!--第一种-->
<item name="android:windowFullscreen">true</item>

//第二种
window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)

//第三种
window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or View.SYSTEM_UI_FLAG_FULLSCREEN

WindowInsetsControllerCompat(window, window.decorView).let {
     it.hide(WindowInsetsCompat.Type.navigationBars())
     it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

用 WindowInsetsController方式实现：

		WindowInsetsControllerCompat(window, window.decorView).let {
            it.hide(WindowInsetsCompat.Type.navigationBars())
            it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

• 2、适配刘海屏的隐藏状态栏。先看一下用上面的方法在挖孔屏上面的实现效果：

可以看到上面有一条很粗的黑边。因为那是前摄挖孔所在，默认显示内容是不能占用挖孔的地方的。
而谷歌 官方是有针对刘海屏的适配方案的，简单的说就是可以让显示内容上移到刘海状态栏的位置。有三种方式供选择：

 //默认情况,全屏页面不可用刘海区域,非全屏页面可以进行使用
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT = 0;

 //不允许使用刘海区域
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER = 2;

 //允许页面延伸到刘海区域
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES = 1;

使用方式如下：

		if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }

但是加上这个只是允许window 可以上升到刘海屏的状态栏，还需要加上 View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 来确保view可以上移到状态栏。具体如下

    fun hideStatusBar(window: Window) {
        //直屏手机一行就搞定
        window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }
        //将显示内容上移到状态栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
    }

用 WindowInsetsController方式实现：

    /**
     * 隐藏状态栏，显示内容上移到状态栏
     */
    fun hideStatusBar3(window: Window) {
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_FULLSCREEN
            it.hide(WindowInsetsCompat.Type.statusBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior =
                WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp

//            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                //将显示内容上移
//                window.setDecorFitsSystemWindows(false)
//            } else {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
//            }
        }
    }

此处 View.View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 之所以不用 window.setDecorFitsSystemWindows(false) 代替，是因为 window.setDecorFitsSystemWindows(false) 还包含有 View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION的作用。如果替代了，则效果如下：

可以看到底部的两行textview都被遮挡了。也就是页面内容延伸到了导航栏底部。

沉浸式状态栏

沉浸式状态栏就很容易理解了，就是把显示的内容上移到状态栏，但是又不隐藏状态栏。（当然直接修改状态栏的颜色，让它和背景一样也是可以的，但是这种仅仅在纯色的情况下实用，如果是图片类的背景就不适用了）。实现如下：

	/**
     * 沉浸式状态栏
     */
    fun transparentStatusBar(window: Window){
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        //view的位置上移到系统栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }

看下效果图：

效果是实现了，但是有点小瑕疵，我们是不希望状态栏遮住我们的内容，但是如果每个页面都要手动计算状态栏的高度然后去设置padding 就过于麻烦了。很简单，在布局文件的根布局加上：

android:fitsSystemWindows="true"

这个属性只有设置了 View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 或View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，才会有效果。
作用呢就是自动给view加上个对应系统栏高度的padding。看下效果：

隐藏导航栏

没啥好说的，直接上代码吧

    /**
     * 隐藏导航栏
     */
    fun hideNavigation(window: Window) {
        //将显示内容下移到导航栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
    }

用 WindowInsetsController方式实现：

    /**
     * 隐藏导航栏
     */
    fun hideNavigation2(window: Window) {
        //将显示内容下移到导航栏
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_HIDE_NAVIGATION
            it.hide(WindowInsetsCompat.Type.navigationBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }
    }

沉浸式导航栏

	/**
     * 沉浸式导航栏，这里就不用WindowInsetsControllerCompat 实现了，因为View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 没办法等效替换
     * fixme :有BUG， View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 不仅仅将内容下移到导航栏，还会上移到状态栏
     */
    fun transparentNavigationBar(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.navigationBarColor = Color.TRANSPARENT
        //view的位置下移到导航栏
        window.decorView.systemUiVisibility =
            View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }

记得要配合 fitsSystemWindows 使用

隐藏状态栏以及导航栏

如果同时使用上面的两个方法组合是不行的。因为 window.decorView.systemUiVisibility 是赋值使用的，后一个会覆盖前一个的。实现如下：

    /**
     * 隐藏两个系统栏
     */
    fun hideSystemBar(window: Window){
        //直屏手机一行就搞定
        window.decorView.systemUiVisibility =
                    // 隐藏系统栏
                    View.SYSTEM_UI_FLAG_FULLSCREEN or
                    // 隐藏导航栏
                    View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or
                    //维持隐藏的效果
                    View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or
                    //将内容往上推到刘海屏的位置
                    View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }
    }

用 WindowInsetsController方式实现：

    /**
     * 隐藏两个系统栏
     */
    fun hideSystemBar2(window: Window) {
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_FULLSCREEN
            it.hide(WindowInsetsCompat.Type.statusBars())
            it.hide(WindowInsetsCompat.Type.navigationBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior =
                WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp

            //在不隐藏系统栏的情况下，将内容移动到系统栏
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                //该方法会同时作用于状态栏以及导航栏
                window.setDecorFitsSystemWindows(false)
            } else {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            }
        }
    }

沉浸式状态栏以及导航栏

    /**
     * 沉浸式状态栏以及导航栏
     */
    fun transparentSystemBar(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        window.navigationBarColor = Color.TRANSPARENT
        //view的位置上移到系统栏
        window.decorView.systemUiVisibility =
                //将内容上移到状态栏
            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or
                    //将内容下移到状态栏
                    View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or
                    View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }

    /**
     * 沉浸式状态栏以及导航栏
     */
    fun transparentSystemBar2(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        window.navigationBarColor = Color.TRANSPARENT

        //在不隐藏系统栏的情况下，将内容移动到系统栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            //该方法会同时作用于状态栏以及导航栏
            window.setDecorFitsSystemWindows(false)
        } else {
            window.decorView.systemUiVisibility =
                View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
        }
    }

记得要配合 fitsSystemWindows 使用

总结

• 1、隐藏状态栏时，刘海屏需要多做两个步骤
  ①：将 window 上移到状态栏位置。
  ②：将decorView 上移到状态栏位置。
  而隐藏导航栏时则直接隐藏即可。
• 2、沉浸式设置都要配合 fitsSystemWindows 使用才不会遮挡显示内容
• 3、隐藏状态栏的时候，如果加上了 fitsSystemWindows 属性，那么在刘海屏手机上也会有一个上边距，如下图，在直屏手机中是正常的。
  -

这篇好文章是转载于：学新通技术网