Android中View.setSystemUiVisibility参数详解

雨点打透心脏的1/2处 2022-05-31 08:06 106阅读 0赞

# 1. 官网原文 #

[Android Doc原文地址][Android Doc]  
`public void setSystemUiVisibility (int visibility)`

> Request that the visibility of the status bar or other screen/window decorations be changed.

> This method is used to put the over device UI into temporary modes where the user’s attention is focused more on the application content, by dimming or hiding surrounding system affordances. This is typically used in conjunction with Window.FEATURE\_ACTION\_BAR\_OVERLAY, allowing the applications content to be placed behind the action bar (and with these flags other system affordances) so that smooth transitions between hiding and showing them can be done.

> Two representative examples of the use of system UI visibility is implementing a content browsing application (like a magazine reader) and a video playing application.

这个方法用于改变状态栏或者其他系统UI的可见性。

这个方法通过变暗或隐藏系统组件，将设备上层UI置于临时模式，使得用户能够将更多的注意力集中在App的内容上。它通常和Window.FEATURE\_ACTION\_BAR\_OVERLAY联合使用，让App的内容显示在ActionBar之后，使其显示和隐藏之间的动画更为平滑。

两个设置系统UI可见性的例子是内容浏览（如杂志阅读器）和视频播放。

# 2. 参数解析 #

在开发透明状态栏的时候，会使用到这段代码（来自[郭霖的博客][Link 1]）：

super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    if (Build.VERSION.SDK_INT >= 21) { 
        View decorView = getWindow().getDecorView();
        int option = View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
        decorView.setSystemUiVisibility(option);
        getWindow().setNavigationBarColor(Color.TRANSPARENT);
        getWindow().setStatusBarColor(Color.TRANSPARENT);
    }
    ActionBar actionBar = getSupportActionBar();
    actionBar.hide();

会用是知其然，但是要知其所以然。那么，这个setSystemUiVisibility方法传入的这个参数，到底起到什么作用呢？

*  SYSTEM\_UI\_FLAG\_FULLSCREEN  
    全屏模式，占据整个屏幕，隐藏状态栏等界面，不过导航栏不会隐藏。**如果用户进行操作，隐藏的系统界面会立马出现并清除该flag。**  
    ![SYSTEM\_UI\_FLAG\_FULLSCREEN][SYSTEM_UI_FLAG_FULLSCREEN]
 *  SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION  
    隐藏导航栏，布局会往下移。**如果用户进行操作，导航栏会立马出现并清除该flag。**  
    ![SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION][SYSTEM_UI_FLAG_HIDE_NAVIGATION]
 *  SYSTEM\_UI\_FLAG\_IMMERSIVE  
    和SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION共同使用，使用户操作不再显示导航栏（但是仍能通过从底部往上滑调出导航栏并清除flag）。**单独使用无效。**
 *  SYSTEM\_UI\_FLAG\_IMMERSIVE\_STICKY  
    和SYSTEM\_UI\_FLAG\_FULLSCREEN以及SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION共同使用。用户操作不再清除flag，从边缘滑入可以调出状态栏和导航栏，并且过几秒之后自动隐藏。**单独使用无效。**  
    ![SYSTEM\_UI\_FLAG\_IMMERSIVE\_STICKY | SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION | SYSTEM\_UI\_FLAG\_FULLSCREEN][SYSTEM_UI_FLAG_IMMERSIVE_STICKY _ SYSTEM_UI_FLAG_HIDE_NAVIGATION _ SYSTEM_UI_FLAG_FULLSCREEN]
 *  SYSTEM\_UI\_FLAG\_LAYOUT\_FULLSCREEN和SYSTEM\_UI\_FLAG\_LAYOUT\_HIDE\_NAVIGATION  
    不隐藏状态栏和导航栏，但是app会按照已经隐藏了那样布局。也就是说，布局会顶上去（占满屏幕），但是会被状态栏/导航栏遮盖住。  
    ![可以看到，最下面那行字被遮住了][aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy82NTMyMjIzLTJlMDkwNmY0ZDUxNjQ0ODkucG5n]
 *  SYSTEM\_UI\_FLAG\_LAYOUT\_STABLE  
    布局变的“稳定”，在状态栏或者导航栏变化的时候不会被顶上去或者顶下去了。  
    事实上，当同时设置了SYSTEM\_UI\_FLAG\_FULLSCREEN和SYSTEM\_UI\_FLAG\_LAYOUT\_STABLE之后，效果相当于SYSTEM\_UI\_FLAG\_LAYOUT\_FULLSCREEN。
 *  SYSTEM\_UI\_FLAG\_LOW\_PROFILE  
    使系统界面不那么“显眼”，用于沉浸式体验。会使状态栏、导航栏等系统UI变暗。

# 3. 合理利用 #

回过头再看开始的代码

uper.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    if (Build.VERSION.SDK_INT >= 21) { 
        View decorView = getWindow().getDecorView();
        int option = View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
        decorView.setSystemUiVisibility(option);
        getWindow().setNavigationBarColor(Color.TRANSPARENT);
        getWindow().setStatusBarColor(Color.TRANSPARENT);
    }
    ActionBar actionBar = getSupportActionBar();
    actionBar.hide();

在普通情况下，整个手机界面从上到下依次是：状态栏、appUI、虚拟导航栏。当设置了SYSTEM\_UI\_FLAG\_LAYOUT\_HIDE\_NAVIGATION和SYSTEM\_UI\_FLAG\_LAYOUT\_FULLSCREEN两个flag之后，实际上appUI已经占到了整个屏幕，但是被状态栏和导航栏覆盖在下层。  
![图示][aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy82NTMyMjIzLTJhY2MzNWFkODMyZjEzZmYucG5n]

这时，再设置状态栏和导航栏的颜色为透明，即可实现透明状态栏的效果了。

当知道了这些flag的作用之后，要实现其他效果也是很轻松了。比如看视频的时候，就可以设置SYSTEM\_UI\_FLAG\_IMMERSIVE\_STICKY | SYSTEM\_UI\_FLAG\_HIDE\_NAVIGATION | SYSTEM\_UI\_FLAG\_FULLSCREEN，就可以实现全屏沉浸式观看的效果了。

[Android Doc]: http://www.android-doc.com/reference/android/view/View.html#setSystemUiVisibility%28int%29
[Link 1]: https://blog.csdn.net/guolin_blog/article/details/51763825
[SYSTEM_UI_FLAG_FULLSCREEN]: /images/20220531/36a9aa076cd9412fab5910267c3cf97c.png
[SYSTEM_UI_FLAG_HIDE_NAVIGATION]: /images/20220531/5a8474cdd3ae4d6587822967c6368e9b.png
[SYSTEM_UI_FLAG_IMMERSIVE_STICKY _ SYSTEM_UI_FLAG_HIDE_NAVIGATION _ SYSTEM_UI_FLAG_FULLSCREEN]: /images/20220531/1ff92b6798d245a1b2a73905f92abd11.png
[aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy82NTMyMjIzLTJlMDkwNmY0ZDUxNjQ0ODkucG5n]: /images/20220531/19ab362a23dc46fd83ed211fa4b1d2ea.png
[aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy82NTMyMjIzLTJhY2MzNWFkODMyZjEzZmYucG5n]: /images/20220531/04893aedf7314e739b29843519f8ba81.png