android开发分享Android 主流 app 的沉浸式效果

什么是沉浸式呢？就是状态栏透明，将 activity 布局延伸到整个屏幕，所呈现的一种模式效果。

白底黑字式

状态栏透明，深色图标文字是地图 app 常见效果：

关于状态栏的展示效果，官方也是调整多多。在 android4.4 版本之前，用户除了通过全屏模式使之消失外，并不能对状态栏操作什么。而在 android5.0 之前，官方提供了 FLAG_TRANSLUCENT_STATUS 标志位，来控制状态栏是否实现渐变的半透明效果。而到了 android5.0 之后，FLAG_TRANSLUCENT_STATUS 标志位所控制的样式也做了调整，从渐变变成了纯粹的半透明。而到了 android6.0 之后，FLAG_TRANSLUCENT_STATUS 效果再次改变，设置此标志可使状态栏全透明。

Android5.0 以上状态栏透明的代码示例：

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {         // android 5.0+ 状态栏透明         Window window = getWindow();         window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);         int option = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN                 | View.SYSTEM_UI_FLAG_LAYOUT_STABLE;         window.getDecorView().setSystemUiVisibility(option);         window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);         window.setStatusBarColor(Color.TRANSPARENT);     } 

考虑到状态栏被设置为透明后，状态栏上的文字和图标存在看不清的情况。Android6.0 以上，系统提供了API 来修改状态栏的字体背景色：

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {         int option = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN                 | View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;         getWindow().getDecorView().setSystemUiVisibility(option);     } 

关于沉浸式，难点在于特殊机型的适配工作上。例如小米和魅族手机，在 android4.4 版本之后，FLAG_TRANSLUCENT_STATUS 标志位便显示为全透明效果，而且自 android4.4 之后，其便提供了设置状态栏图标和文字颜色的内部方法。

特殊（1）魅族

详情参考开放平台，下载 StatusbarColorUtils 类，接口见下：

    /**      * 设置状态栏字体图标颜色      *      * @param activity 当前activity      * @param dark     是否深色 true为深色 false 为白色      */     public static void setStatusBarDarkIcon(Activity activity, boolean dark) {         setStatusBarDarkIcon(activity, dark, true);     } 

特殊（2）OPPO

详情参考开放平台，对 Android 版本是 6.0 及以后的 OPPO 机型，使用 Google 提供View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR 的 Flag 来设置状态栏图标黑色显示效果。

对 Android5.1 版本并且是 ColorOS3.0 的 OPPO 机型使用 ColorOS 提供 SYSTEM_UI_FLAG_OP_STATUS_BAR_TINT 的 Flag 来设置状态栏图标黑色效果，由于该标记未公开，开发者需要在应用代码中定义。

    final int SYSTEM_UI_FLAG_OP_STATUS_BAR_TINT = 0x00000010;     Window window = getWindow();     window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);     window.getDecorView().setSystemUiVisibility(SYSTEM_UI_FLAG_OP_STATUS_BAR_TINT); 

为方便开发者对于 OPPO 机型的反色适配，提供了用于设置状态栏显示效果的接口方法，开发者可以根据应用需要动态设置状态栏图标为白色或是黑色。接口传入值 ture 时状态栏图标为黑色，接口转入值为 false 状态栏图标为白色：

    public void setLightStatusBarIcon(boolean lightMode) {         Window window  = getWindow();         window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);         int vis = window.getDecorView().getSystemUiVisibility();         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {             if (lightMode) {                 vis |= View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;             } else {                 vis &= ~View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;             }         } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.L) {             if (lightMode) {                 vis |= SYSTEM_UI_FLAG_OP_STATUS_BAR_TINT;             } else {                 vis &= ~SYSTEM_UI_FLAG_OP_STATUS_BAR_TINT;             }         }         window.getDecorView().setSystemUiVisibility(vis);     } 

特殊（3）小米

详情参考开放平台，在 Android 6.0 以前，Android 没有方法可以实现“状态栏黑色字符”效果，因此 MIUI 自己做了一个接口。在 Android 6.0 及以上版本，Android 提供了标准的方法实现“状态栏黑色字符”效果，但这个方法和 MIUI 的方法产生了冲突。

在新的 MIUI 开发版 7.7.13 及以后版本（基于 Android 6.0 ），设置代码：

    Window window = getWindow();     window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);     window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);     window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR); 

在旧的 MIUI 版本，仍然需要使用 MIUI 原有的方法，即：

    public void setStatusBarDarkMode(boolean darkmode, Activity activity) {         Class<? extends Window> clazz = activity.getWindow().getClass();         try {             int darkModeFlag = 0;             Class<?> layoutParams = Class.forName("android.view.MiuiWindowManager$LayoutParams");             Field field = layoutParams.getField("EXTRA_FLAG_STATUS_BAR_DARK_MODE");             darkModeFlag = field.getInt(layoutParams);             Method extraFlagField = clazz.getMethod("setExtraFlags", int.class, int.class);             extraFlagField.invoke(activity.getWindow(), darkmode ? darkModeFlag : 0, darkModeFlag);         } catch (Exception e) {             e.printStackTrace();         }     } 

待续