前言

刘海屏是指某些设备显示屏上的一个区域延伸到显示面，这样既能为用户提供全面屏体验，又能为设备正面的重要传感器留出空间。Android在搭载Android 9.0/P（API 级别 28）及更高版本的设备上正式支持刘海屏。设备制造商也可以选择在搭载Android 8.1或更低版本的设备上支持刘海屏。

官方地址：

https://developer.android.com/guide/topics/display-cutout

Android 9.0及以上：

layoutInDisplayCutoutMode

Android允许控制是否在刘海区域内显示内容。窗口布局属性layoutInDisplayCutoutMode控制内容如何呈现在刘海区域中：

• LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT：这是默认行为，如上所述。在竖屏模式下，内容会呈现到刘海区域中；但在横屏模式下，内容会显示黑边。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES：在竖屏模式和横屏模式下，内容都会呈现到刘海区域中。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER：内容从不呈现到刘海区域中。
• LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS：内容始终呈现到刘海区域中。

DisplayCutout

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

通过代码演示不同窗口及layoutInDisplayCutoutMode的区别：

主题

将主题修改成不带ActionBar的样式

<resources xmlns:tools="http://schemas.android.com/tools">
    <!-- Base application theme. -->
    <style name="Theme.PBangScreenDemo" parent="Theme.MaterialComponents.DayNight.NoActionBar">
        XXXXX
    </style>
</resources>

布局

将文本顶在布局的左上角，方便演示

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/holo_orange_dark"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

代码

检测是否是刘海屏，如果存在刘海屏，则给布局增加一个PaddingTop

    @RequiresApi(api = Build.VERSION_CODES.P)
    private void detect() {
        final View decorView = getWindow().getDecorView();
        decorView.post(new Runnable() {
            @Override
            public void run() {
                WindowInsets rootWindowInsets = decorView.getRootWindowInsets();
                if (rootWindowInsets == null) {
                    return;
                }
                DisplayCutout displayCutout = rootWindowInsets.getDisplayCutout();
                if (displayCutout == null) {
                    return;
                }
                Log.e("yzt", "安全区域距离屏幕左边的距离>>>" + displayCutout.getSafeInsetLeft());
                Log.e("yzt", "安全区域距离屏幕右部的距离>>>" + displayCutout.getSafeInsetRight());
                Log.e("yzt", "安全区域距离屏幕顶部的距离>>>" + displayCutout.getSafeInsetTop());
                Log.e("yzt", "安全区域距离屏幕底部的距离>>>" + displayCutout.getSafeInsetBottom());
                List<Rect> rects = displayCutout.getBoundingRects();
                if (rects == null || rects.size() == 0) {
                    Log.e("yzt", "不是刘海屏");
                } else {
                    Log.e("yzt", "刘海屏数量>>>" + rects.size());
                    for (Rect rect : rects) {
                        Log.e("yzt", "刘海屏区域>>>" + rect);
                    }
                    layout.setPadding(0, displayCutout.getSafeInsetTop(), 0, 0);
                }
            }
        });
    }

全屏情况

设置全屏，写在setContentView()之前

        getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);

设置layoutInDisplayCutoutMode

        WindowManager.LayoutParams lp = getWindow().getAttributes();
        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_XXXXX;
        getWindow().setAttributes(lp);

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT模式

1.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES模式

2.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER模式

3.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS模式

4.jpg

透明状态栏情况

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

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT模式

5.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES模式

6.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER模式

7.jpg

LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS模式

8.jpg

可以看出当刘海区域完全在系统的状态栏时，LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT的显示效果与LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES一致。

完整代码

public class MainActivity extends AppCompatActivity {

    private View layout;

    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);
//        getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
        setContentView(R.layout.activity_main);
        WindowManager.LayoutParams lp = getWindow().getAttributes();
        //在竖屏模式下，内容会呈现到刘海区域中；但在横屏模式下，内容会显示黑边。
//        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT;
        //在竖屏模式和横屏模式下，内容都会呈现到刘海区域中。
        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
        //内容从不呈现到刘海区域中。
//        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER;
        //内容始终呈现到刘海区域中。
//        lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS;
        getWindow().setAttributes(lp);
        layout = findViewById(R.id.layout);
        detect();
    }

    @RequiresApi(api = Build.VERSION_CODES.P)
    private void detect() {
        final View decorView = getWindow().getDecorView();
        decorView.post(new Runnable() {
            @Override
            public void run() {
                WindowInsets rootWindowInsets = decorView.getRootWindowInsets();
                if (rootWindowInsets == null) {
                    return;
                }
                DisplayCutout displayCutout = rootWindowInsets.getDisplayCutout();
                if (displayCutout == null) {
                    return;
                }
                Log.e("yzt", "安全区域距离屏幕左边的距离>>>" + displayCutout.getSafeInsetLeft());
                Log.e("yzt", "安全区域距离屏幕右部的距离>>>" + displayCutout.getSafeInsetRight());
                Log.e("yzt", "安全区域距离屏幕顶部的距离>>>" + displayCutout.getSafeInsetTop());
                Log.e("yzt", "安全区域距离屏幕底部的距离>>>" + displayCutout.getSafeInsetBottom());
                List<Rect> rects = displayCutout.getBoundingRects();
                if (rects == null || rects.size() == 0) {
                    Log.e("yzt", "不是刘海屏");
                } else {
                    Log.e("yzt", "刘海屏数量>>>" + rects.size());
                    for (Rect rect : rects) {
                        Log.e("yzt", "刘海屏区域>>>" + rect);
                    }
                    layout.setPadding(0, displayCutout.getSafeInsetTop(), 0, 0);
                }
            }
        });
    }

}

Android 9.0以下

上面是Android P才有的解决方案。然而国产厂商在Android P之前（基本都是Android O）就用上了高档大气上档次的刘海屏，所以，这也造就了各大厂商在Android P之前的解决方案百花齐放。这里不详细介绍。

结尾

核心思路就是判断是否带有刘海屏，根据自己的项目判断窗口的情况，再去决定是否需要做适配，如果需要适配再去根据实际的设计要求做适配。