小米手机全面屏手势提示线（虚拟键）适配说明-APP开发

小米手机全面屏手势提示线（虚拟键）适配说明

1.背景

MIUI12将加入”手势提示线”,在设置-更多设置-全面屏中，可以通过开关打开/关闭该功能。手势提示线的实现原理参考了原生的方式，和虚拟按键在同一个window当中，可以理解成是虚拟按键的一种新的形态。

适配的原则是:”手势提示线”(也就是虚拟键）的背景颜色和页面整体的背景颜色保持一致；
主要有两种适配方式:”使用沉浸式虚拟键”和“给虚拟键设置合适的颜色”。

图例为开启“手势提示线”效果图例为关闭“手势提示线”效果

2.使用沉浸式虚拟键

2.1如何设置

沉浸式虚拟键，即app的content view延伸到虚拟键区域，虚拟键的颜色透明。类似的，还有沉浸式状态栏，即app的content view延伸到状态栏区域，状态栏的颜色透明。

有两种设置的方式，参考代码如下。

方式1：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.test_layout);
 
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);       //设置沉浸式状态栏，在MIUI系统中，状态栏背景透明。原生系统中，状态栏背景半透明。
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);   //设置沉浸式虚拟键，在MIUI系统中，虚拟键背景透明。原生系统中，虚拟键背景半透明。
}

方式2：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.test_layout);
 
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    getWindow().setStatusBarColor(Color.TRANSPARENT);
    getWindow().setNavigationBarColor(Color.TRANSPARENT);
    getWindow().getDecorView().setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_LAYOUT_STABLE|
        View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN|
        View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
    );
}

2.2可能存在的问题

设置了沉浸式虚拟键和沉浸式状态栏之后，状态栏和虚拟键会遮挡住app的内容，效果如下：

2.3解决方案

如果不希望app的内容被遮挡，可以给view设置 android:fitsSystemWindows=”true”，设置之后，系统会给该view自动加上paddingTop和paddingBottom。参考代码和效果如下:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/apps_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#0000FF"
    android:fitsSystemWindows="true">

2.4适用的场景举例

当页面具有复杂的背景或纹理时：

3.给虚拟键设置合适的颜色

3.1如何设置

使用setNavigationBarColor来设置虚拟键的颜色。注意不要单独把颜色设置成透明，如果要设置成透明的话，参考上面的沉浸式虚拟键，配合其他flag使用。

参考下面的代码，按照这种方式设置之后，app的content view将不会延伸到虚拟键区域。

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.test_layout);
 
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    getWindow().setStatusBarColor(Color.BLUE);     //设置状态栏的背景颜色
    getWindow().setNavigationBarColor(Color.BLUE);  //设置虚拟键的背景颜色
}