Android 刘海屏适配全攻略

0.版权声明

本文由玉刚说写作平台提供写作赞助，版权归玉刚说微信公众号所有
原作者：四月葡萄
版权声明：未经玉刚说许可，不得以任何形式转载

1.前言

先吐槽一下，刘海屏真丑。然而作为苦逼的开发者，还是要去适配刘海屏的。好了，吐槽完毕，进入正题。

这里主要是介绍一下Android P中刘海屏的适配以及Android P之前的适配。为什么要分开呢？因为Android P之前官方还没提供API来进行适配，都是由各家厂商来提供适配方案的。

2.Android P中的刘海屏适配

2.1 Google对刘海屏的支持介绍

Google将刘海屏命名为屏幕缺口了，这一小节内容摘自Android官方介绍：
屏幕缺口支持

Android P 支持最新的全面屏以及为摄像头和扬声器预留空间的凹口屏幕。 通过全新的 DisplayCutout 类，可以确定非功能区域的位置和形状，这些区域不应显示内容。 要确定这些凹口屏幕区域是否存在及其位置，请使用 getDisplayCutout() 函数。

全新的窗口布局属性 layoutInDisplayCutoutMode 让您的应用可以为设备凹口屏幕周围的内容进行布局。 您可以将此属性设为下列值之一：

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER

您可以按如下方法在任何运行 Android P 的设备或模拟器上模拟屏幕缺口：

1. 启用开发者选项。
2. 在 Developer options（开发者选项） 屏幕中，向下滚动至 Drawing（绘图） 部分并选择 Simulate a display with a cutout（模拟具有凹口的显示屏）。
3. 选择凹口屏幕的大小。

注：我们建议您通过使用运行 Android P 的设备或模拟器测试凹口屏幕周围的内容显示。

2.2 Android P提供提供的刘海屏适配方案

1. 对于有状态栏的页面，不会受到刘海屏特性的影响，因为刘海屏包含在状态栏中了；
2. 全屏显示的页面，系统刘海屏方案会对应用界面做下移处理，避开刘海区显示，这时会看到刘海区域变成一条黑边，完全看不到刘海了；
3. 已经适配Android P应用的全屏页面可以通过谷歌提供的适配方案使用刘海区，真正做到全屏显示。

2.3 Android P中支持的凹口屏幕类型

目前Android支持了三类凹口屏幕类型：边角显示屏凹口（斜刘海）、双显示屏凹口（刘海+胡子）、长型显示屏凹口（刘海），如下图所示：

目前的手机主要还是长型显示屏凹口，即刘海屏。其他斜刘海和胡子手机应该还没有实物吧？反正是亮瞎了狗眼了。

2.4 刘海屏布局及安全区域说明

2.5 Android P中凹口屏幕相关接口

注意，以下接口都是要Build.VERSION.SDK_INT >= 28才能调用到。

2.5.1 DisplayCutout类接口

主要用于获取凹口位置和安全区域的位置等。主要接口如下所示：

方法	接口说明
getBoundingRects()	返回Rects的列表，每个Rects都是显示屏上非功能区域的边界矩形。
getSafeInsetLeft ()	返回安全区域距离屏幕左边的距离，单位是px。
getSafeInsetRight ()	返回安全区域距离屏幕右边的距离，单位是px。
getSafeInsetTop ()	返回安全区域距离屏幕顶部的距离，单位是px。
getSafeInsetBottom()	返回安全区域距离屏幕底部的距离，单位是px。

来看下例子。
这里将开发者选项中的模拟具有凹口的显示屏选项改为双显示屏凹口，即这里应当有两个刘海，然后，直接上代码：

public class NotchActivity extends Activity {
   
    @Override
    protected void onCreate(Bundle savedInstanceState) {
   
        super.onCreate(savedInstanceState);

        //开局就一张背景图
        setContentView(R.layout.notch);

        getNotchParams();
    }

    @TargetApi(28)
    public void getNotchParams() {
   
        final View decorView = getWindow().getDecorView();

        decorView.post(new Runnable() {
   
            @Override
            public void run() {
   
                WindowInsets rootWindowInsets = decorView.getRootWindowInsets();
                if (rootWindowInsets == null) {
   
                    Log.e("TAG", "rootWindowInsets为空了");
                    return;
                }
                DisplayCutout displayCutout = rootWindowInsets.getDisplayCutout();
                Log.e("TAG", "安全区域距离屏幕左边的距离 SafeInsetLeft:" + displayCutout.getSafeInsetLeft());
                Log.e("TAG", "安全区域距离屏幕右部的距离 SafeInsetRight:" + displayCutout.getSafeInsetRight());
                Log.e("TAG", "安全区域距离屏幕顶部的距离 SafeInsetTop:" + displayCutout.getSafeInsetTop());
                Log.e("TAG", <