沉浸式含义
首先先明确一点沉浸式状态栏的说法并不准确,沉浸式是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);
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样式为:
可以看出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方法即可实现效果
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))