Android全面屏设备如何判断并适配刘海屏区域？

Question

在Android全面屏设备开发中，如何判断并适配刘海屏区域是一个常见问题。不同厂商的刘海屏可能具有不同的尺寸和位置，若不正确处理，可能导致界面元素被遮挡或显示异常。为解决此问题，开发者可使用`WindowInsets`或`DisplayCutout` API（从Android P开始支持）来检测刘海屏区域的位置和大小。通过`View.getRootWindowInsets().getDisplayCutout()`方法获取刘海区域信息，包括安全区域边界。同时，在布局设计时，建议使用`android:fitsSystemWindows="true"`属性或调整布局参数，确保内容避开刘海区域。对于低版本系统，则需借助第三方库或手动计算状态栏高度进行兼容处理。这种适配方式能有效提升应用在各类全面屏设备上的显示效果和用户体验。

Answer 1

在Android全面屏设备中适配刘海屏（Display Cutout）需要结合系统API和厂商定制方案，以下为分版本、分场景的详细技术适配方案：

一、基础适配原则

声明屏幕支持‌
在AndroidManifest.xml中声明支持刘海屏：

<meta-data 
    android:name="android.max_aspect" 
    android:value="2.4" />
<meta-data
    android:name="android.notch_screen"
    android:value="true"/>  <!-- 华为/小米等厂商特定声明 -->

强制全屏显示‌
在Activity中启用全屏模式（避免系统自动避让）：

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

二、Android P+ 官方适配方案（API 28+）

获取刘海区域信息‌
通过DisplayCutout对象获取精确数据：

View decorView = getWindow().getDecorView();
WindowInsets insets = decorView.getRootWindowInsets();
DisplayCutout cutout = insets.getDisplayCutout();

if (cutout != null) {
    // 获取刘海区域边界
    List<Rect> boundingRects = cutout.getBoundingRects();
    // 获取安全区域
    Rect safeInsets = new Rect(
        cutout.getSafeInsetLeft(),
        cutout.getSafeInsetTop(),
        cutout.getSafeInsetRight(),
        cutout.getSafeInsetBottom()
    );
}

动态布局避让‌
使用WindowManager.LayoutParams设置内容显示模式：

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

三、低版本兼容方案（API <28）

1. 状态栏高度计算（通用方法）

public int getStatusBarHeight() {
    int result = 0;
    int resourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
    if (resourceId > 0) {
        result = getResources().getDimensionPixelSize(resourceId);
    }
    return result;
}

1. 厂商私有API检测

// 华为设备
public static boolean hasHuaweiNotch(Context context) {
    try {
        ClassLoader cl = context.getClassLoader();
        Class HwNotchSizeUtil = cl.loadClass("com.huawei.android.util.HwNotchSizeUtil");
        Method get = HwNotchSizeUtil.getMethod("hasNotchInScreen");
        return (boolean) get.invoke(HwNotchSizeUtil);
    } catch (Exception e) {
        return false;
    }
}

// 小米设备
public static boolean hasXiaomiNotch(Context context) {
    return context.getResources().getBoolean(android.R.bool.config_isScreenNotch);
}

四、多场景布局适配策略

XML布局避让‌
使用安全区域作为布局边距：

<LinearLayout
    android:paddingTop="@dimen/safe_inset_top"
    android:paddingBottom="@dimen/safe_inset_bottom">

ConstraintLayout动态约束‌
通过代码动态设置边距：

ConstraintLayout.LayoutParams params = (ConstraintLayout.LayoutParams) view.getLayoutParams();
params.topMargin = safeInsets.top;
view.setLayoutParams(params);

横竖屏适配‌
监听屏幕方向变化：

// 在Activity中重写
@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    updateCutoutSafeArea();
}

五、测试与验证方案

开发者选项模拟刘海‌
启用Settings -> Developer options -> Simulate a display with a cutout

ADB强制刘海模式‌

adb shell settings put global debug.cutout_meizu 1  # 魅族刘海模拟
adb shell settings put global debug.cutout_type 1   # 通用类型

多厂商真机测试清单‌

厂商 测试设备示例 特殊配置项
华为 Mate 30 Pro hw.notch.force.blackapp
小米 Mi 11 ro.miui.notch
OPPO Find X oppo.screen.heteromorphism
六、进阶优化建议

使用AndroidX库‌
通过androidx.core:core库简化兼容代码：

WindowCompat.setDecorFitsSystemWindows(window, false);

刘海区域绘图穿透‌
允许内容延伸到刘海区域时的绘制控制：

view.setClipToPadding(false);
view.setClipChildren(false);

游戏引擎适配‌
Unity引擎可通过修改Player Settings -> Resolution Scaling -> Hide Cutout配置

总结适配流程
声明全屏和刘海屏支持 → 2. 检测当前设备刘海类型 → 3. 动态计算安全区域 → 4. 调整布局边距 → 5. 多设备验证 → 6. 处理横竖屏切换

通过系统API与厂商方案结合，可覆盖95%以上的全面屏设备，建议优先使用WindowInsets方案，厂商方案作为兜底策略。