沉浸式含义

首先先明确一点沉浸式状态栏的说法并不准确，沉浸式是Android4.4推出的一种模式，可以使显示系统消息的状态栏（Status Bar）与最下方显示虚拟按键的底部导航栏(Navigation Bar)被隐藏掉。
在谷歌开发文档中对沉浸式的描述是：“系统 UI 保持隐藏状态，即使在用户与您的应用或游戏交互时 - 您可以从屏幕上的任何位置（甚至在系统栏占据的其他位置）捕获触摸事件。这是您在应用或游戏中创建更大、更加丰富和更加沉浸式的 UI 并减少视觉分散的绝佳方式。”

Android4.4沉浸式API

1、沉浸式全屏模式
setSystemUiVisibility (int visibility)
看了下标记多达十来个，以下截取部分常用标记：

SYSTEM_UI_FLAG_FULLSCREEN（WindowManager.LayoutParams.FLAG_FULLSCREEN）//隐藏状态栏，手指在屏幕顶部往下拖动，状态栏会再次出现且不会消失
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN //配合SYSTEM_UI_FLAG_FULLSCREEN使用状态栏出现时，不会挤压activty的高度，隐藏状态栏，手指在屏幕顶部往下拖动，状态栏会再次出现且不会消失

SYSTEM_UI_FLAG_IMMERSIVE// 这个标记仅与SYSTEM_UI_FLAG_HIDE_NAVIGATION配合使用，在全屏模式下在状态栏区域滑动会重新显示状态栏
SYSTEM_UI_FLAG_IMMERSIVE_STICKY//在全屏模式下在状态栏区域滑动会重新显示透明式状态栏，一会后会重新隐藏，与SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION配合产生效果。

SYSTEM_UI_FLAG_HIDE_NAVIGATION//隐藏导航栏，手指在导航栏滑动，导航栏会再次出现且不会消失
SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION//配合SYSTEM_UI_FLAG_HIDE_NAVIGATION使用导航栏会出现时，不会挤压activty的高度，隐藏导航栏会，手指在导航栏滑动，导航栏会再次出现且不会消失

SYSTEM_UI_FLAG_LAYOUT_STABLE //保持内容主体位置不变，不随着Systembar的隐藏显示而偏移

2、透明系统状态栏
新增两个新主题背景Theme_Holo_NoActionBar、Theme_Holo_Light_NoActionBar，如果需要不应被系统状态栏覆盖的布局部分则应该启用fitsSystemWindows。
对于fitsSystemWindows，官方的说法是“布尔内部属性，用于根据系统窗口（如状态栏）调整视图布局。如果为true，则调整此视图的填充以为系统窗口留出空间。仅在此视图位于非嵌入活动中时才会生效。”默认值为false

如果需要创建自定义主题，可将其中一个设置为父主题背景或者在样式中添加windowTranslucentNavigation（对应WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS）与windowTranslucentStatus（WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION）

Android5.0沉浸式API

在Android5.0开始官方提供了android:statusBarColor （对应方法为 setStatusBarColor），且窗口必须使用FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS绘制系统栏背景
不得设置FLAG_TRANSLUCENT_STATUS。

Android9.0全面屏API

Android9.0开始增加对全全面屏的适配
具体增加以下三种标记

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT（只有当DisplayCutout完全包含在系统状态栏中时，才允许窗口延伸到DisplayCutout区域显示）
LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES（该窗口始终允许延伸到屏幕短边上的DisplayCutout区域）
LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER（该窗口决不允许与DisplayCutout区域重叠）

android9.0全面屏沉浸式代码

        getWindow().getDecorView().setSystemUiVisibility( View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN );
        WindowManager.LayoutParams lp = getWindow().getAttributes();
        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
        getWindow().setAttributes(lp);
        window.setStatusBarColor(Color.TRANSPARENT);

沉浸式分析

以下沉浸式实现以两种情况做分析分别式图片沉浸式和ActionBar沉浸式

图片沉浸式(隐藏状态栏图标)

图片沉浸式的应用相对较多最常见的例如splash页面

Android 4.4

getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);    
getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
getWindow().getDecorView().setSystemUiVisibility(system_ui_flag_fullscreen|system_ui_flag_hide_navigation);

image.png

Android 5.0

getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);    
getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
getWindow().getDecorView().setSystemUiVisibility(system_ui_flag_fullscreen|system_ui_flag_hide_navigation);

同Android4.4

Android 9.0

window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
WindowManager.LayoutParams lp = getWindow().getAttributes();
lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
getWindow().setAttributes(lp);
getWindow().getDecorView().setSystemUiVisibility(system_ui_flag_fullscreen|system_ui_flag_hide_navigation);

Android9.0提供新标记（LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES）来适配全面屏、刘海屏等异形屏。

ActionBar沉浸式(显示状态栏图标)

Android 4.4

getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);                
getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);

使用如上代码 所呈现的UI样式为：

image.png

可以看出actionBar占住了statusBar的位置，如果statusBar上有图标可能会与actionBar重叠，由于当前是在Android4.4上执行的demo，不能使用
setStatusBarColor方法。所以我们可以在actionBar增加一个与statusBar一摸一样的View，使之呈现出沉浸式感觉。
具体代码：

    /**
     * 创建一个与statusBar一样的View
     * @param color View颜色
     */
    private View createStatusBarView(Activity activity, int color) {
        // 绘制一个和状态栏一样高的矩形
        View statusBarView = new View(activity);
        Log.i(TAG,"statusBarHeight:"+getStatusBarHeight());
        LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                getStatusBarHeight());
        statusBarView.setLayoutParams(params);
        statusBarView.setBackgroundColor(color);
        return statusBarView;
    }
    /**
     * 获取statusBar高度
     */
    private int getStatusBarHeight(){
    int height = 0;
        int resourceId = getApplicationContext().getResources().getIdentifier("status_bar_height", "dimen", "android");
        if (resourceId > 0) {
            height = getApplicationContext().getResources().getDimensionPixelSize(resourceId);
        }
        return height;
    }

    /**
     * setFitsSystemWindows
     */
    private static void setRootView(Activity activity) {
        //获取到activity_main.xml文件
        ViewGroup rootView = (ViewGroup) ((ViewGroup) activity.findViewById(android.R.id.content)).getChildAt(0);
        //如果不设置参数，会使内容显示到状态栏上
        rootView.setFitsSystemWindows(true);
    }
    /**
     * 创建barView
     */
    private void createBarView(int color) {
        //1、创建与statusBar相同高度的view
        View statusView = createStatusBarView(this, color);
        //2、添加statusView到布局中
        ViewGroup decorView = (ViewGroup) this.getWindow().getDecorView();
        decorView.addView(statusView);
        //3、让布局适应屏幕
        setRootView(this);
    }

直接调用createBarView方法即可实现效果

image.png

Android 5.0

window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)     
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);           
window.setStatusBarColor(getResources().getColor(R.color.colorPrimaryDark));

由于Android 5.0新增API:setStatusBarColor，直接使用即可

Android 9.0

window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)     
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);           
window.setStatusBarColor(getResources().getColor(R.color.colorPrimaryDark))