安卓 刘海屏兼容开发

随着手机屏幕的不断地变大，功能的不断扩展，一种新的屏幕形式出现了——刘海屏。刘海屏是指屏幕顶部留出一个小区域，用来放置摄像头、听筒、传感器等硬件元素。对于安卓开发来说，需要针对刘海屏进行适配，为用户提供更加优秀的使用体验。

一、原理

1、适配刘海屏

适配刘海屏涉及到三个步骤：

在 xml 中设置布局时，需要减去刘海区域的高度；

在启动时对刘海区域进行适配，需要重写 activity 的方法；

对于不同机型，需要获取刘海区域的高度和宽度，来进行不同机型的细节适配。

2、获取刘海屏高度和宽度

对于不同的机型，刘海屏的高度和宽度不同。为了解决这个问题，需要借助安卓 SDK 提供的 API 来获取刘海屏尺寸信息。

Android P 新增了 DisplayCutout 类，通过 DisplayCutout 类可以获取到刘海屏的坐标和尺寸信息。而在 Android P 以下版本中，可以通过安卓 SDK 提供的系统属性或反射的方式实现获取刘海区域信息。

3、使用适配 API

为了保证适配刘海屏的效果，需要使用适配 API。即当 Android 系统的版本号大于 Android P 时，需要使用 DisplayCutout 类中的 API 获取刘海屏的尺寸信息；否则需要使用安卓 SDK 提供的系统属性或反射的方式获取刘海区域信息。

二、详细介绍

1、适配刘海屏

为了适配刘海屏，需要在开发时注意以下几点：

避免布局覆盖刘海区域。当布局覆盖刘海区域时，可能会影响刘海区域中的硬件元素，对使用者产生影响。因此，我们需要确保布局不会覆盖刘海区域。

适配刘海屏的尺寸样式。不同的机型，刘海屏的样式不同，例如一个圆形、一个矩形或是两个半圆形等等。为了适应不同的机型，需要获取刘海屏的尺寸信息，来进行不同的样式适配。

2、获取刘海屏高度和宽度

获取刘海屏高度和宽度可以通过安卓 SDK 提供的 API 来实现。在 Android P 中，可以通过 DisplayCutout 类中的 API 获取刘海屏的尺寸信息：

``` kotlin

val windowInsets = view.rootWindowInsets

val displayCutout = windowInsets?.displayCutout

if (displayCutout != null) {

val safeInsetTop = displayCutout.safeInsetTop // 安全区域离屏幕顶部的距离

val safeInsetLeft = displayCutout.safeInsetLeft // 安全区域离屏幕左侧的距离

val safeInsetRight = displayCutout.safeInsetRight // 安全区域离屏幕右侧的距离

val safeInsetBottom= displayCutout.safeInsetBottom // 安全区域离屏幕底部的距离

}

```

而在 Android P 以下版本中，可以通过安卓 SDK 提供的系统属性来实现获取刘海区域信息：

``` kotlin

private val WINDOW_INSET_TOP = "ro.miui.notch_top"

private val WINDOW_INSET_LEFT = "ro.miui.notch_left"

private val WINDOW_INSET_RIGHT = "ro.miui.notch_right"

private val WINDOW_INSET_BOTTOM = "ro.miui.notch_bottom"

fun hasNotch(context: Context): Boolean {

val value = getIntProperty(context, WINDOW_INSET_LEFT)

return value > 0

}

fun getNotchParams(context: Context): Rect {

val rect = Rect(0, 0, 0, 0)

val isNotch = hasNotch(context)

if (isNotch) {

rect.left = getIntProperty(context, WINDOW_INSET_LEFT)

rect.right = getIntProperty(context, WINDOW_INSET_RIGHT)

rect.top = getIntProperty(context, WINDOW_INSET_TOP)

rect.bottom = getIntProperty(context, WINDOW_INSET_BOTTOM)

}

return rect

}

fun getIntProperty(context: Context, key: String, defaultValue: Int = 0): Int {

return try {

val clazz = Class.forName("android.os.SystemProperties")

val method = clazz.getMethod("getInt", String::class.java, Int::class.java)

method.invoke(clazz, key, defaultValue) as Int

} catch (e: Exception) {

defaultValue

}

}

```

在上述代码中，`hasNotch()` 方法用来判断当前手机是否有刘海，`getNotchParams()` 方法用来获取刘海区域的尺寸信息。

3、使用适配 API

为了适配刘海屏，需要使用安卓 SDK 提供的适配 API。根据不同的机型，刘海屏的尺寸和样式会有所不同。因此，我们需要根据机型信息来选择对应的适配方法。

在 Android P 及以上版本中，需要使用 DisplayCutout 类中的 API 来获取刘海区域的尺寸信息：

``` kotlin

ViewCompat.setOnApplyWindowInsetsListener(view) { _, windowInsets ->

val displayCutout = windowInsets.displayCutout

if (displayCutout != null) {

// 适配刘海屏

}

windowInsets

}

```

而在 Android P 及以下版本中，我们可以使用系统属性或反射的方式来获取刘海区域信息：

``` kotlin

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.P) {

val notchParams = NotchUtil.getNotchParams(this)

val layoutParams = view.layoutParams as ViewGroup.MarginLayoutParams

layoutParams.setMargins(notchParams.left, notchParams.top, notchParams.right, 0)

view.layoutParams = layoutParams

}

```

在上述代码中，我们先通过 `NotchUtil.getNotchParams()` 方法获取到刘海屏的尺寸信息，然后通过修改布局的 margin 实现刘海屏适配。

总之，为了适配刘海屏，我们需要根据不同机型的刘海屏样式，获取刘海区域的尺寸信息，并根据获取到的信息来进行适配。