Activity 全屏，沉浸式模式这一篇就够了

本文由小钙投稿。

小钙的博客地址：

http://blog.csdn.net/zhangqinghuazhangzhe

第一次在项目中要用到全屏功能的时候无从下手，然后就是去百度了。百度到的结果都是差不多的。不过直接把代码贴过来的确是可以用的。但是除了知道怎么做之外还想去理解它，因为只有理解了才能举一反三嘛。好在在后来的时候看到了官方的文档，写的非常详细。

•  我是官方文档

（https://developer.android.com/training/system-ui/index.html）

接下来开始正题

… 
… 
…

先给出一些名词方便下面的讲解

StatusBar:

NavigationBar:

SystemBar 为：StatusBar 跟 NavigationBar 的统称

设置全屏主要分为两种方式：

• 4.0 之前采用的方式

• 4.0 之后新增的方式

因为 4.0 之前的系统已经很少了，所以这里就简单的说一下。 

有两种方式可以实现全屏：

• 使用全屏的主题

• getWindow().addFlag(WindowManager.LayoutParams.FLAG_FULLSCREEN)

  
  

这种全屏方式是无法隐藏 NavigationBar 的（如果有 NavigationBar 的话），因为 NavigationBar 是在 4.0 以后才引入的。使用这种方式设置全屏的特点是，离开了 App 后再进入 App 时，依然处于全屏模式，只能清除掉全屏标志位才能退出全屏。

4.1 以及之后使用 View 的 setSystemUiVisibility() 来对 SystemBar 进行控制。 

任何 View 都可以用来调用这个方法，只要它是可见状态的。

下面先把要涉及到的 flag 分组列举出来（所有的 flag 都是以 SYSTEM_UI_FLAG 作为前缀，所以下面将其省略）。

控制 SystemBar 相关：

• FULLSCREEN

• HIDE_NAVIGATION

• LOW_PROFILE

布局相关：

• LAYOUT_SCREEN

• LAYOUT_HIDE_NAVIGATION

• LAYOUT_STABLE

  
  

沉浸式相关 (4.4 引入)：

• IMMERSIVE

• IMMERSIVE_STICKY

超前提示：

在离开 App 时，比如按了 home / 多任务键 会导致设置的控制 SystemBar 相关的 flag 被清除，而其他设置的 flag 不会受到影响。

虽然写的是 Fullscreen ，但其实只是隐藏 StatusBar。

看图可以得出以下几点：

1. 点击屏幕 StatusBar 不会显示出来

2. 从屏幕上边缘往下滑可以让 StatusBar 重新显示

3. 点击 home / 多任务键再返回 App 时 StatusBar 重新显示了出来，印证了超前提示里所说的。而且 StatusBar 在显示出来以后不会自动隐藏，这一点跟在 4.1 之前设置的全屏方式不一样，因为设置的 FULLSCREEN flag 已经被清除了，如果想重新隐藏，需要重新设置该 flag。

4. StatusBar 的显示 / 隐藏会使 ImageView 大小发生了变化

为了防止布局大小不会因为 StatusBar 的显示 / 隐藏发生变化，有两种 flag 可供选择：

1. LAYOUT_STABLE

mDecorView.setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_FULLSCREEN 
                | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);

这里有一点需要注意：设置多个标志位时要用 | 连接起来，不能多次调用 setSystemUiVisibility。如：

mDecorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN);
mDecorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_STABLE);

这样的结果就是只有最后一次设置的 flag 生效，而之前设置的标志位会被清除。也就是说上面的代码中只设置了 LAYOUT_STABLE 而 FULLSCREEN 被清除了。所以如果想清除之前设置的所有 flag ，mDecorView.setSystemUiVisibility(0) 就可以了

这次布局并没有延伸到 StatusBar 底下，所以大小也就不会受到它的影响

2.LAYOUT_FULLSCREEN

mDecorView.setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_FULLSCREEN 
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);

protected void onCreate(Bundle savedInstanceState) {
    mDecorView.setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_FULLSCREEN
            | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION);
}

Google 建议隐藏 NavigationBar 的同时将 StatusBar 一起隐藏。

与隐藏 StatusBar 时不同的是，隐藏了 NavigationBar 以后，点击屏幕的任何位置都会导致设置的所有控制 SystemBar 相关的 flag 被清除，所以 SystemBar 重新显示了出来。

这里还需要注意的在这种模式下点击屏幕点击事件会被屏蔽，要等到 SystemBar 显示出来以后再次点击，事件才会传递到我们的布局中。

与 LAYOUT_FULLSCREEN 类似的是， LAYOUT_HIDE_NAVIGATION 可以让布局内容延伸到 NavigationBar 的底部。

因为离开 App 后控制 SystemBar 相关的 flag 会被清除，所以可以按需在 onResume() 或者 
onWindowFocusChanged() 中重新设置它们。

protected void onCreate(Bundle savedInstance) {
    mDecorView.setSystemUiVisibility(
                View.SYSTEM_UI_FLAG_LOW_PROFILE);
}

这种模式好像用的不多，作用是减少 StatusBar 中的图标并使其变暗，将 NavigationBar 中的按钮减弱成 3 个点。 
直接上图来说明该 flag 的效果吧：

需要配合 View.SYSTEM_UI_FLAG_FULLSCREEN 和 View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 一起设置

mDecorView.setSystemUiVisibility(
            View.SYSTEM_UI_FLAG_LAYOUT_STABLE
            | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
            | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION 
            | View.SYSTEM_UI_FLAG_FULLSCREEN
            | View.SYSTEM_UI_FLAG_IMMERSIVE);

可以看到设置了该 flag 以后，点击屏幕不会让 SystemBar 显示出来。而在呼出 SystemBar 后，控制 SystemBar 相关的 flag 依然会被清除。

跟 IMMERSIVE 不同的是，在该模式下呼出的 SystemBar 会在短暂的显示后自动重新隐藏。在 SystemBar 显示出来的时候点击屏幕中心会立刻让 SystemBar 重新隐藏。所以在模式下不会清除控制 SystemBar 相关的 flag。但是离开 App 时还是会被清除。

所以在回到 App 的时候要重新激活它：

@Override
public void onWindowFocusChanged(boolean hasFocus) {
        super.onWindowFocusChanged(hasFocus);
    if (hasFocus) {
        decorView.setSystemUiVisibility(
            View.SYSTEM_UI_FLAG_LAYOUT_STABLE
            | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
            | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
            | View.SYSTEM_UI_FLAG_FULLSCREEN
            | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);}
}

通常情况下我们需要能够控制 SystemBar 的显示与隐藏，所以就需要监听 SystemBar 的状态。

• FULLSCREEN（4）

• HIDE_NAVIGATION（2）

• LOW_PROFILE（1）

括号中的数字是它们的值，现在让我们回到代码中。

onSystemUiVisibilityChange(int visibility) 中的 visibility 表示的是 LOW_PROFILE、FULLSCREEN 跟 HIDE_NAVIGATION 这三个值的和。

因为只有这 3 个值是跟控制 SystemBar 相关的。

也就是说从 visibility 的值就可以只知道我们设置了哪些 flag。

比如如果 visibility 为 4，说明设置了 FULLSCREEN；

如果 visibility 为 7 则说明 3 种 flag 都设置了。

所以当 visibility 为 0 时表示没有设置任何控制 SystemBar 的 flag，也就说明了 SystemBar 处于显示状态。

为什么 visibility 的值会是它们三个的和呢？因为我们在设置 flag 的时候是用 | 将多个 flag 连接在一起的， | 就相当于把它们的值加起来。

当 SystemBar 显示或者隐藏的时候，该监听器就会被触发。但是如果使用的是 IMMERSIVE_STICKY ，在 SystemBar 被呼出的时候不会触发该监听器。

下面给出一个 Demo ，功能是点击图片时进入/退出全屏

这里有一个问题，如果点击稍微快一点的话就会出现只隐藏 StatusBar 而没有隐藏 NavigationBar 的情况。如果有哪个小伙伴知道的话请告知一下。

希望这篇文章能给大家带来一点点帮助。

如果你有好的文章想和大家分享，欢迎投稿，直接向我投递文章链接即可。

欢迎长按下图->识别图中二维码或者扫一扫关注我的公众号：