SystemUI Flag详解及使用情景

能够造成SystemUI Flag被系统自动清除的交互分类

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

SystemUI Flag 相关特性详解

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)
   作用:避免某些用户交互造成系统自动清除全屏状态。

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

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

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

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

   • 当使用此Flag时，设置fitSystemWindow=true的view，会被系统自动添加大小为NavigationBar高度相同的paddingBottom。
   • 当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的内容的位置也不会发生移动。

   • 当使用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如此操作，也会是一样的效果。
   1. 当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN时，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN，不会因为StatusBar的显示或隐藏不会造成内容view的不稳定。
   2. 当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION，不会因为StatusBar和导航栏的显示或隐藏不会造成内容view的不稳定。
   3. 此特性不应该只配合SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION使用
   4. 使用WindowManager.LayoutParams.FLAG_FULLSCREEN（而不是使用SYSTEM_UI_FLAG_FULLSCREEN）来隐藏StatusBar是一个一直持续隐藏的状态。这时你仍然可以使用SYSTEM_UI_FLAG_FULLSCREEN | SYSTEM_UI_FLAG_LAYOUT_STABLE隐藏Actionbar，并且不会因为ActionBar的显示或隐藏而不稳定。

fitSystemWindow

只有设置了View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION或View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，View的 fitSystemWindow=true才会有效果。

WindowManager 相关特性详解

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

SystemUI Flag引起的软键盘变化

在使用SOFT_INPUT_ADJUST_RESIZE，
同时View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN或View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION时，当键盘弹出时，只会fitSystemWindow=true的view所占区域会被resize，其他view将会被软键盘覆盖。

常用情形

1. 隐藏状态栏
   代码实例1

private fun hideStatusBar(){
    layout.systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN
}

注意：用户的第二、四类交互操作都会使系统自动清除状态栏隐藏状态（系统会自动取消View.SYSTEM_UI_FLAG_FULLSCREEN的设置）

代码实例2

private fun hideStatusBar(){
    var tag = (View.SYSTEM_UI_FLAG_FULLSCREEN
            or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY)
    layout.systemUiVisibility = tag
}

注意：用户的第四类交互操作会使系统自动清除状态栏隐藏状态（系统会自动取消View.SYSTEM_UI_FLAG_FULLSCREEN的设置，但是不会取消View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY）；用户的第二类操作会使状态栏暂时显示，延迟几秒后自动消失。

代码实例3

private fun hideStatusBar(on: Boolean) {
    val winParams = window.attributes
    val bits = WindowManager.LayoutParams.FLAG_FULLSCREEN
    if (on) {//隐藏状态栏
        winParams.flags = winParams.flags or bits
    } else {//显示状态栏
        winParams.flags = winParams.flags and bits.inv()
    }
    window.attributes = winParams
}

注意：1.用户任何交互操作都不会使系统自动清除状态栏隐藏状态；用户的第二类操作会是状态栏暂时显示，延迟几秒后自动消失。
2.使用此flag,系统会自动忽略输入法的SOFT_INPUT_ADJUST_RESIZE的特性。

1. 透明状态栏
   代码实例1：半透明状态栏

private fun translateStatusBar(on: Boolean) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        var p = window.attributes
        p.flags = p.flags or WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS
        window.attributes = p
    }
}

注意：为避免状态栏遮挡View上的部分信息，需要为View设置fitSystemWindow=true，或手动设置padding

代码实例2：透明状态栏

private fun translateStatusBar() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        var tag = (View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            or View.SYSTEM_UI_FLAG_LAYOUT_STABLE)
        layout.systemUiVisibility = tag
    }
}

注意：
- Android的状态栏的字体颜色默认为白色，只有Android6.0以后才提供官方的API选择黑色字体（View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR）。所以当6.0以下使用透明状态栏时，若StatusBar下面的View的也为白色背景时，则会造成看不到StatusBar的相关信息。
- 为避免状态栏遮挡View上的部分信息，需要为View设置fitSystemWindow=true，或手动设置padding

1. 隐藏导航栏
   代码实例1

private fun hideNavigationBar(){
    layout.systemUiVisibility = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
}

注意：用户的任何操作都会使系统自动清除此状态。SYSTEM_UI_FLAG_HIDE_NAVIGATION被系统自动清除时会连带清除SYSTEM_UI_FLAG_FULLSCREEN

代码实例2

private fun hideNavigationBar(){
    var tag = (View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
            or View.SYSTEM_UI_FLAG_IMMERSIVE)
    layout.systemUiVisibility = tag
}

注意：用户的第三、四类交互操作会使系统自动清除此状态；用户的第二类操作会是状态栏暂时显示，延迟几秒后自动消失

代码实例3

private fun hideNavigationBar(){
    var tag = (View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
            or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY)
    layout.systemUiVisibility = tag
}

注意：用户的第四类交互操作会使系统自动清除此状态；用户的第三类操作会是使导航栏暂时显示，延迟几秒后自动消失

1. 全屏模式
   代码实例1：一般用于视频播放的情形

private fun fullScreen(){
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
        var tag = (View.SYSTEM_UI_FLAG_FULLSCREEN
                or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_STABL)
        layout.systemUiVisibility = tag
    } 
}

注意： 用户的任何交互都会导致全屏状态被系统清除

代码实例2：一般用于沉浸阅读的情形

private fun fullScreen(){
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
        var tag = (View.SYSTEM_UI_FLAG_FULLSCREEN
                or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
                or View.SYSTEM_UI_FLAG_IMMERSIVE)
        layout.systemUiVisibility = tag
    } 
}

代码实例3：：一般用于游戏等严格沉浸的情形

private fun fullScreen(){
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
        var tag = (View.SYSTEM_UI_FLAG_FULLSCREEN
                or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
                or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY)
        layout.systemUiVisibility = tag
    } 
}

1. 修改SystemBar的颜色
   代码实例1

private fun setSystemBarColor(int color){
    window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS|WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION)
    window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
    window.statusBarColor = color
    window.navigationBarColor = color
}