Android 刘海屏适配方案---NotchTools,适配国内四大厂商（华为、小米、oppo、vivo）刘海屏手机，根据自己业务需求，提供多种接入方式适配刘海屏

最新推荐文章于 2024-03-24 04:43:11 发布
最新推荐文章于 2024-03-24 04:43:11 发布
阅读量1.5k 收藏 4
点赞数
分类专栏： Android 不错文章转载
原文链接：https://p.codekk.com/detail/Android/zhangzhun132/NotchTools
版权

NotchTools

项目地址：zhangzhun132/NotchTools 

简介： 💥💥Android 刘海屏适配方案---NotchTools,适配国内四大厂商（华为、小米、oppo、vivo）刘海屏手机，根据自己业务需求，提供多种接入方式适配刘海屏。

更多：作者   提 Bug   官网   

标签：

 

image

刘海屏指的是手机屏幕上方由于追求极致边框而采用的方案，表现为在顶部有块黑色遮挡，长得像刘海，所以叫刘海屏。

目前 google 在 Android P 上已经对刘海屏的适配进行了统一，所以在 targetApi >= 28 上可以使用谷歌官方推荐的适配方案进行刘海屏适配。但是在 Android O 版本的刘海屏如何适配呢？这就是本文要重点阐述的内容了：

1、对国内四大厂商（华为、小米、OPPO、VIVO）对 Android O 版本刘海屏的适配方案进行介绍； 2、对 Android P 版本的刘海屏进行适配； 3、提出对 Android O 版本刘海屏的通用解决方案，包括全屏占用刘海屏、全屏不占用刘海屏两种情况； 4、提出适配工具NotchTools解决方案，让你的应用简单快捷的适配全面屏

2、适配与未适配的效果对比

因为相比普通常规手机而言，刘海屏顶部中间会突出一块刘海区域，所以会在给 Actiivty 设置全屏 Flag 的时候有一些不同。本文所涉及到的刘海屏适配都是在给 Activity 的 window 设置 SYSTEM_UI_FLAG_FULLSCREEN（全屏 flag）前提下的，在显示状态栏的情况下（不管是状态栏透明或者不透明），不是本文讨论的核心，我们的所说的刘海屏适配只是针对全屏沉浸式（状态栏隐藏）的情况下。

在设置 SYSTEM_UI_FLAG_FULLSCREEN 了 Flag 后，国内厂商的刘海屏手机对于此表现的默认显示效果都是有差异的，具体为： 1、华为手机默认是全屏但是不占用刘海区域； 2、小米手机默认是全屏但是不占用刘海区域； 3、oppo 手机默认是全屏且占用刘海区域，可在设置里单独给 APP 设置是否隐藏刘海； 4、vivo 手机默认是全屏且占用刘海区域，可在设置里单独给 APP 设置是否隐藏刘海；

 

备注：通过实验及查阅文档发现，华为和小米适配方案是类似的且适配方案成熟，oppo、和 vivo 的适配介绍是类似的，且基本无适配方案。华为、小米会分别对全屏占用刘海、全屏不占用刘海两种情况分别提供了方法。而 oppo、vivo 只提供了是否有刘海这个一个方法，并没有提供适配方案。

所以我们再全屏的情况下需要对四大厂商做下适配，不然有可能一个 App 在不同手机上表现不一致、或者会对 UI 做了截断，影响使用体验：

占用刘海显示的刘海屏 未占用刘海显示的刘海屏

3、适配方案

Android O 的刘海屏适配方案可分为两种情况：

3、1 全屏且占用刘海屏的适配方案

对于需要全屏且占用刘海屏显示的情况，如沉浸式游戏、沉浸式阅读（需要把态栏隐藏），适配时可以采用如下步骤： 1、在 Activity 中使用 setSystemUiVisibility 设置全屏的一些标识； 2、根据不同厂商的适配规则（官网有提供）设置不同的 flag（大都通过反射），来让 App 全屏沉浸式显示； 3、根据厂商提供的 Api，获取刘海的高度，来调节一些 View 的间距，达到适配目的。

3、2 全屏但不占用刘海的适配方案

这种适配方案一般采用如下步骤: 1、去各大手机厂商官网找到对应的全屏但不占用刘海的方案，目前只有小米、华为提供了具体方法来设置是否占用刘海区域，oppo 和 vivo 只提供了机型是否是刘海屏手机的方法，但未提供适配方案; 2、华为和小米都有具体方案来适配全屏不占用刘海的情况，这里主要对 vivo 和 oppo 进行适配。 这里要说明下，在系统设置里可以设置刘海是否隐藏，不过华为、小米是全局设置，而 ov 是可以单独对 app 进行设置，又因为 ov 没有提供具体的适配方案，所以对于 ov 的全屏适配达不到完美的适配，在不占用刘海时顶部会留出一块黑边。

3.3 华为手机刘海屏适配方案

华为手机刘海屏适配方案

3.3.1 判断华为手机是否为刘海屏手机

 @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public boolean isNotchScreen(Window window) {
        boolean isNotchScreen = false;
        try {
            ClassLoader cl = window.getContext().getClassLoader();
            Class HwNotchSizeUtil =   cl.loadClass("com.huawei.android.util.HwNotchSizeUtil");
            Method get = HwNotchSizeUtil.getMethod("hasNotchInScreen");
            isNotchScreen = (boolean) get.invoke(HwNotchSizeUtil);
        } catch (ClassNotFoundException e) {
            LogUtils.d(TAG, "hasNotchInScreen ClassNotFoundException");
        } catch (NoSuchMethodException e) {
            LogUtils.d(TAG, "hasNotchInScreen NoSuchMethodException");
        } catch (Exception e) {
            LogUtils.d(TAG, "hasNotchInScreen Exception");
        } finally {
            return isNotchScreen;
        }
    }

3.3.2 获取华为手机的刘海屏高度


        @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public int getNotchHeight(Window window) {
        if (!isNotchScreen(window)) {
            return 0;
        }
        int[] ret = new int[]{0, 0};
        try {
            ClassLoader cl = window.getContext().getClassLoader();
            Class HwNotchSizeUtil = cl.loadClass("com.huawei.android.util.HwNotchSizeUtil");
            Method get = HwNotchSizeUtil.getMethod("getNotchSize");
            ret = (int[]) get.invoke(HwNotchSizeUtil);
        } catch (ClassNotFoundException e) {
        } catch (NoSuchMethodException e) {
        } catch (Exception e) {
        } finally {
            return ret[1];
        }
    }

3.3.3 设置页面在华为刘海屏手机使用刘海区

    @TargetApi(Build.VERSION_CODES.KITKAT)
    public static void setFullScreenWindowLayoutInDisplayCutout(Window window) {
        if (window == null) {
            return;
        }
        WindowManager.LayoutParams layoutParams = window.getAttributes();
        try {
            Class layoutParamsExCls = Class.forName("com.huawei.android.view.LayoutParamsEx");
            Constructor con=layoutParamsExCls.getConstructor(WindowManager.LayoutParams.class);
            Object layoutParamsExObj=con.newInstance(layoutParams);
            Method method=layoutParamsExCls.getMethod("addHwFlags", int.class);
            method.invoke(layoutParamsExObj, FLAG_NOTCH_SUPPORT);
        } catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException |InstantiationException
                | InvocationTargetException e) {
            Log.e("test", "hw add notch screen flag api error");
        } catch (Exception e) {
            Log.e("test", "other Exception");
        }
    }

3.3.4 设置页面在华为刘海屏手机不使用刘海区

    @RequiresApi(api = Build.VERSION_CODES.KITKAT)
    public static void setNotFullScreenWindowLayoutInDisplayCutout (Window window) {
        if (window == null) {
            return;
        }
        WindowManager.LayoutParams layoutParams = window.getAttributes();
        try {
            Class layoutParamsExCls = Class.forName("com.huawei.android.view.LayoutParamsEx");
            Constructor con=layoutParamsExCls.getConstructor(WindowManager.LayoutParams.class);
            Object layoutParamsExObj=con.newInstance(layoutParams);
            Method method=layoutParamsExCls.getMethod("clearHwFlags", int.class);
            method.invoke(layoutParamsExObj, FLAG_NOTCH_SUPPORT);
        } catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException |InstantiationException
                | InvocationTargetException e) {
            Log.e("test", "hw clear notch screen flag api error");
        } catch (Exception e) {
            Log.e("test", "other Exception");
        }
    }

3.4 小米手机刘海屏适配方案

3.4.1 判断小米手机是否为刘海屏手机

 @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public boolean isNotchScreen(Window window) {
        return "1".equals(SystemProperties.getInstance().get("ro.miui.notch"));
    }

3.4.2 获取小米手机刘海屏高度


    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public int getNotchHeight(Window window) {
        if (!isNotchScreen(window)) {
            return 0;
        }

        int result = 0;
        if (window == null) {
            return 0;
        }
        Context context = window.getContext();
        if (isHideNotch(window.getContext())) {
            result = NotchStatusBarUtils.getStatusBarHeight(context);
        } else {
            result = getRealNotchHeight(context);
        }
        return result;
    }

3.4.3 设置页面在小米刘海屏手机使用刘海区

在 WindowManager.LayoutParams 增加 extraFlags 成员变量，用以声明该 window 是否使用耳朵区，其中，extraFlags 有以下变量：

0x00000100 开启配置
0x00000200 竖屏配置
0x00000400 横屏配置

组合后表示 Window 的配置，如：

0x00000100 | 0x00000200 竖屏绘制到耳朵区
0x00000100 | 0x00000400 横屏绘制到耳朵区
0x00000100 | 0x00000200 | 0x00000400 横竖屏都绘制到耳朵区

控制 extraFlags 时注意只控制这几位，不要影响其他位。可以用 Window 的 addExtraFlags 和 clearExtraFlags 来修改, 这两个方法是 MIUI 增加的方法，需要反射调用。

设置页面在小米刘海屏手机使用刘海区代码如下：

    public void fullScreenUseStatus(Activity activity, OnNotchCallBack notchCallBack) {
        super.fullScreenUseStatus(activity, notchCallBack);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && isNotchScreen(activity.getWindow())) {
            //开启配置
            int FLAG_NOTCH = 0x00000100 | 0x00000200 | 0x00000400;
            try {
                Method method = Window.class.getMethod("addExtraFlags", int.class);
                if (!method.isAccessible()) {
                    method.setAccessible(true);
                }
                method.invoke(activity.getWindow(), FLAG_NOTCH);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

3.4.4 设置页面在小米刘海屏手机不使用刘海区

   @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public void fullScreenDontUseStatus(Activity activity, OnNotchCallBack notchCallBack) {
        super.fullScreenDontUseStatus(activity, notchCallBack);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && isNotchScreen(activity.getWindow())) {
            //开启配置
            int FLAG_NOTCH = 0x00000100 | 0x00000400;
            try {
                Method method = Window.class.getMethod("addExtraFlags", int.class);
                if (!method.isAccessible()) {
                    method.setAccessible(true);
                }
                method.invoke(activity.getWindow(), FLAG_NOTCH);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }

3.4.5 小米刘海屏手机上刘海屏高度与状态栏高度差异

由于 Notch 设备的状态栏高度与正常机器不一样，因此在需要使用状态栏高度时，不建议写死一个值，而应该改为读取系统的值。

以下是获取当前设备状态栏高度的方法：

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

以下是获取当前设备刘海高度的方法：

int resourceId = context.getResources().getIdentifier("notch_height", "dimen", "android");
if (resourceId > 0) {
result = context.getResources().getDimensionPixelSize(resourceId);
}

3.5 OPPO 手机刘海屏适配方案

image

3.5.1 判断 OPPO 手机是否为刘海屏手机

    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public boolean isNotchScreen(Window window) {
        if (window == null) {
            return false;
        }
        return window.getContext().getPackageManager().hasSystemFeature("com.oppo.feature.screen.heteromorphism");
    }

3.5.2 获取 OPPO 手机刘海屏高度

目前 OPPO 刘海屏适配的官网上并没有给出获取刘海高度的方法，也没有给出占用刘海区域、不占用刘海区域的方法。 官网上给的图上的刘海的固定高度是 80px，这里通过获取状态栏高度的方法得到值也是 80，大概猜测 OPPO 手机的刘海高度是和状态栏高度一样的。

   @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public int getNotchHeight(Window window) {
        if (!isNotchScreen(window)) {
            return 0;
        }

        return NotchStatusBarUtils.getStatusBarHeight(window.getContext());
    }

3.5.3 设置页面在 OPPO 刘海屏手机使用刘海区

OPPO 手机并没有像小米、华为手机一样提供具体的方法设置刘海区域，但是 OPPO 手机在全屏状态下默认是占用刘海区域的，是完全沉浸式的，所以只需设置全屏 Flag 即可：

 public static void setFullScreenWithSystemUi(final Window window, boolean setListener) {
        int systemUiVisibility = 0;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
            systemUiVisibility = View.SYSTEM_UI_FLAG_FULLSCREEN
                    | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

                    | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                    | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION;
        }

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            systemUiVisibility |= View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY;
        }
        window.getDecorView().setSystemUiVisibility(systemUiVisibility);

        if (setListener) {
            window.getDecorView().setOnSystemUiVisibilityChangeListener(new View.OnSystemUiVisibilityChangeListener() {
                @Override
                public void onSystemUiVisibilityChange(int visibility) {
                    if (visibility == 0) {
                        setFullScreenWithSystemUi(window, false);
                    }
                }
            });
        }
    }

3.5.4 设置页面在 OPPO 刘海屏手机不使用刘海区

因为 OPPO 手机默认是全屏占用刘海区域的，所以如果想达到全屏且不占用刘海区域的话，需要在 Activty 的顶部通过添加一个状态栏高度的黑色布局，来下移整体布局，从而视觉上看起来是已经适配了。

    @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public void fullScreenDontUseStatus(Activity activity, OnNotchCallBack notchCallBack) {
        NotchStatusBarUtils.setFullScreenWithSystemUi(activity.getWindow(), true);
        onBindCallBackWithNotchProperty(activity, notchCallBack);
        if (isNotchScreen(activity.getWindow())) {
            NotchStatusBarUtils.setFakeNotchView(activity.getWindow());
        }
    }

protected void onBindCallBackWithNotchProperty(Activity activity, OnNotchCallBack notchCallBack) {
        if (notchCallBack != null) {
            NotchProperty notchProperty = new NotchProperty();
            notchProperty.setNotchHeight(getNotchHeight(activity.getWindow()));
            notchProperty.setNotch(isNotchScreen(activity.getWindow()));
            if (notchCallBack != null) {
                notchCallBack.onNotchPropertyCallback(notchProperty);
            }
        }
    }

 

代码中通过 NotchStatusBarUtils.setFakeNotchView 为你的 layout 布局中最顶部的 View 容器添加一个状态栏高度的 View，从而使整体布局下移，也就达到了全屏但是不占用状态栏区域的目的。

setFakeNotchView 的方法如下：

   public static void setFakeNotchView(Window window) {
        ViewGroup notchContainer = removeFakeNotchView(window);
        if (notchContainer == null) {
            return;
        }
        View view = new View(window.getContext());
        view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
                NotchTools.getFullScreenTools().getNotchHeight(window)));
        view.setBackgroundColor(Color.BLACK);
        notchContainer.addView(view);
    }


   public static ViewGroup removeFakeNotchView(Window window) {
        ViewGroup notchContainer = getNotchContainer(window);
        if (notchContainer == null) {
            return null;
        }
        int childCount = notchContainer.getChildCount();
        if (childCount > 0) {
            notchContainer.removeAllViews();
        }
        return notchContainer;
    }

    public static ViewGroup getNotchContainer(Window window) {

        View decorView = window.getDecorView();
        if (decorView == null) {
            return null;
        }
        return decorView.findViewWithTag(NotchTools.NOTCH_CONTAINER);
    }

原理是在自己的 Activity 布局中防止一个 viewContainer，然后给这个 viewContainer 设置一个 TAG，在适配 OPPO 机型全屏不占用刘海情况时可以通过 findViewWithTag 来找到这个 viewConatiner，然后在这个 viewContainer 中添加一个刘海高度的黑色布局，即达到整体布局下移的视觉效果，具体可参考源码。

3.6 VIVO 手机刘海屏适配方案

3.6.1 判断 VIVO 手机是否为刘海屏手机

  @RequiresApi(api = Build.VERSION_CODES.O)
    @Override
    public boolean isNotchScreen(Window window) {
        if (window == null) {
            return false;
        }
        if (mClass == null) {
            ClassLoader classLoader = window.getContext().getClassLoader();
            try {
                mClass = classLoader.loadClass("android.util.FtFeature");
                mMethod = mClass.getMethod("isFeatureSupport", Integer.TYPE);
                return (boolean) mMethod.invoke(mClass, 0x00000020);
            } catch (ClassNotFoundException e) {
                return false;
            } catch (NoSuchMethodException e) {
                return false;
            } catch (IllegalAccessException e) {
                return false;
            } catch (InvocationTargetException e) {
                return false;
            }
        } else {
            if (mMethod == null) {
                try {
                    mMethod = mClass.getMethod("isFeatureSupport", Integer.TYPE);
                } catch (NoSuchMethodException e) {
                    return false;
                }
                try {
                    return (boolean) mMethod.invoke(mClass, 0x00000020);
                } catch (IllegalAccessException e) {
                    return false;
                } catch (InvocationTargetException e) {
                    return false;
                }
            }
        }
        return false;
    }

3.6.2 设置页面在 VIVO 刘海屏手机使用刘海区

与 oopo 一致

3.6.3 设置页面在 VIVO 刘海屏手机不使用刘海区

与 oppo 一致

3.7 Android P 版本适配

3.7.1 Android P 刘海介绍

Android P 提供了 3 种显示模式供开发者选择，分别是：

默认模式（LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT） 刘海区绘制模式（ LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES） 刘海区不绘制模式（LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER）

由于各个厂商的刘海或者凹口形状、位置不一， 开发者可以通过 WindowInsets.getDisplayCutout() 来获得 DisplayCutout object。

3.7.2 判断手机是否为刘海屏手机

 @RequiresApi(api = 28)
    @Override
    public boolean isNotchScreen(Window window) {
        WindowInsets windowInsets = window.getDecorView().getRootWindowInsets();
        if (windowInsets == null) {
            return false;
        }

        DisplayCutout displayCutout = windowInsets.getDisplayCutout();
        if(displayCutout == null || displayCutout.getBoundingRects() == null){
            return false;
        }

        return true;
    }

3.7.3 获取刘海高度

    @RequiresApi(api = 28)
    @Override
    public int getNotchHeight(Window window) {
        int notchHeight = 0;
        WindowInsets windowInsets = window.getDecorView().getRootWindowInsets();
        if (windowInsets == null) {
            return 0;
        }

        DisplayCutout displayCutout = windowInsets.getDisplayCutout();
        if(displayCutout == null || displayCutout.getBoundingRects() == null){
            return 0;
        }

        notchHeight = displayCutout.getSafeInsetTop();

        return notchHeight;
    }

3.7.4 Android P 全屏不占用刘海

    @RequiresApi(api = 28)
    @Override
    public void fullScreenDontUseStatus(Activity activity, OnNotchCallBack notchCallBack) {
        super.fullScreenDontUseStatus(activity, notchCallBack);
        if (isNotchScreen(activity.getWindow())) {
            WindowManager.LayoutParams attributes = activity.getWindow().getAttributes();
            attributes.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER;
            activity.getWindow().setAttributes(attributes);
        }
    }

3.7.5 Android P 全屏占用刘海

   @RequiresApi(api = 28)
    @Override
    public void fullScreenUseStatus(Activity activity, OnNotchCallBack notchCallBack) {
        super.fullScreenUseStatus(activity, notchCallBack);
        if (isNotchScreen(activity.getWindow())) {
            WindowManager.LayoutParams attributes = activity.getWindow().getAttributes();
            attributes.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
            activity.getWindow().setAttributes(attributes);
        }
    }

3.7.6 适配 Android P 时注意事项

适配 Android P 时我们需要获取到 WindowInsets 对象，这个对象是通过 window.getDecorView().getRootWindowInsets()获取的。我们一般在给 Activity 适配时需要在 Activity 的 onCreate 方法中完成，但是这个时候获取到的 WindowInsets 对象可能为 null，所以在给 Android P 适配时需要通过 handler.post 方法完成，如：

ThreadUtils.post2UI(new Runnable() {
            @Override
            public void run() {
                if (notchScreenSupport == null) {
                    checkScreenSupportInit(activity.getWindow());
                }
                if (notchScreenSupport != null) {
                    notchScreenSupport.fullScreenDontUseStatus(activity, notchCallBack);
                }
            }
        });

3.8 在旋转屏幕时的适配

我们一般会在 Activity 的 onCreate 方法中对 Activity 进行刘海适配，但是在一些涉及到视频播放的场景下，会有横屏旋转隐藏状态栏、竖屏时显示状态栏的情况，大部分这些逻辑都是写在底层视频播放逻辑中的，所以我们在做涉及到有可能重设状态栏 Flag 的情况下，需要进行一些设置，具体为： 1、在 Activity 的 onCreate 中设置 SYSTEM_UI_FLAG_FULLSCREEN,且完成刘海屏适配 2、在 Activity 的 onWindowFocusChanged 方法中，再次调用刘海屏适配方法，防止横屏时重置了相关适配，然后再回到竖屏了因为 flag 的配置不对，导致显示异常。

4 NotchTools适配工具

基于前面的适配规则，简单的对刘海屏全屏适配封装了一个工具----NotchTools。NotchTools 的初衷是尽可能简单的进行刘海屏适配，其中包括全屏占用刘海区域、全屏不占用刘海屏区域两种情况，对于透明状态栏的情况，没有进行适配（原理是和全屏占用刘海屏区域是一样的），NotchTools只处理全屏（隐藏状态栏）的情况。

特别说明：

对于使用刘海区域的情况，因为有时候需要对 layout 文件的部分 view 进行下移刘海或者状态栏的高度达到适配的目的，但有的时候又不希望对布局或 view 进行下移，所以 NotchTools 工具在全屏且占用刘海区域的情况下未做下移处理，使用者可以在 OnNotchCallBack 的回调中，获得状态栏高度，然后自行完成下移操作，具体代码在 FullScreenUseNotchActivity 有给出使用方式。

4.1 如何使用

4.1.1 NotchTools 适配全屏但不占用刘海情况

使用方法为在 Activity 的 onCreate 方法中使用如下代码：

NotchTools.getFullScreenTools().fullScreenDontUseStatus(this, new OnNotchCallBack() {
            @Override
            public void onNotchPropertyCallback(NotchProperty notchProperty) {

            }
        });

或者
NotchTools.getFullScreenTools().fullScreenDontUseStatus(this);

4.1.2 NotchTools 适配全屏且占用刘海情况

同理，在需要处理的 Activity 的 onCreate 中使用如下代码：

NotchTools.getFullScreenTools().fullScreenUseStatus(this, new OnNotchCallBack() {
            @Override
            public void onNotchPropertyCallback(NotchProperty notchProperty) {
                int marginTop = notchProperty.getMarginTop();
                RelativeLayout.LayoutParams layoutParams = (RelativeLayout.LayoutParams) mBackView.getLayoutParams();
                layoutParams.topMargin += marginTop;
                mBackView.setLayoutParams(layoutParams);
            }
        });

对于需要使用刘海区域的适配中，使用者需要在 OnNotchCallBack 回调的 onNotchPropertyCallback 方法中获取状态栏高度 notchHeight，然后自行去为自己的布局或者 View 做下移操作，这样灵活性更好一点。

4.1.3 NotchTools 额外说明

NotchTools 中的 Activity 都继承了 BaseActivity，BaseActivity 的代码如下：

    /**
     * 刘海容器
     */
    private FrameLayout mNotchContainer;
    /**
     * 主内容区
     */
    private FrameLayout mContentContainer;

    @Override
    public void setContentView(int layoutResID) {
        super.setContentView(R.layout.activity_base);
        mNotchContainer = findViewById(R.id.notch_container);
        mNotchContainer.setTag(NotchTools.NOTCH_CONTAINER);
        mContentContainer = findViewById(R.id.content_container);
        onBindContentContainer(layoutResID);
    }

    private void onBindContentContainer(int layoutResID) {
        LayoutInflater.from(this).inflate(layoutResID, mContentContainer, true);
    }

BaseActivity 内部重载了 setContentView(int layoutResID)方法，在 layoutResID 的上方添加了一个 Framelayout,也就是刘海的父容器，默认情况下他是一个空布局，但是在全屏不占用刘海的情况下，为了适配 OV 手机（OV 手机没有具体方法来实现全屏不占用刘海）,所以需要在 mNotchContainer 中放入刘海高度的黑色 View，来下移整体布局，达到适配目的。

5 总结

本文讨论了 Android O 及 Android P 机型中适配刘海屏的原理、方法、和解决方案，并提供了源码供参考。

题外话：对于 Android O 上的各大产商提供的适配方案，有的厂商在官网上明确说明了会在 Android P 上进行兼容，也就是 O 的适配方案依然在未来的 P 机型上可行。但是有的厂商已经在官网明确说明了在未来的 Android P 上不会兼容 O 的适配方案，所以，适配还是任重而道远。

有问题随时微信联系，微信号：gold_soldier 顺便骗个 star: NotchTools 源码地址

有问题或改建方案微信联系

Wei_Leng
关注
专栏目录
android刘海屏适配工具,NotchScreenTool
weixin_34697798的博客
05-26 926
具体的适配过程可以查看这篇博客：安装项目根目录的build.gradle中添加：allprojects {repositories {google()jcenter()maven { url "https://jitpack.io" } // 添加 jitpack}}在 module 层级的build.gradle中添加依赖implementation 'com.github.smarxpan:N...
android获取刘海屏状态栏高度,Android刘海屏全面屏底部导航栏的适配
weixin_35548486的博客
05-25 859
关于Android状态栏和虚拟导航栏的适配，文章：https://blog.csdn.net/leogentleman/article/details/54566319讲的很不错。状态栏的适配：在activity里设置了View decorView = getWindow().getDecorView();int uiOptions = View.SYSTEM_UI_FLAG_HIDE_NAVIG...
NotchScreenTool-master.zip
06-09
现在，市面上的屏幕尺寸和全面屏方案五花八门，而最常见的就是刘海屏，不过对于右侧较小的刘海，业界一般称为水滴屏或美人尖。
王学岗 Android 判断手机是否是刘海屏
qczg_wxg的博客
03-16 4403
package com.aliyun.svideo.common.utils; import android.annotation.SuppressLint; import android.content.Context; import android.util.Log; import android.view.Window; import android.view.WindowManager; import java.lang.reflect.Constructor; import java.lang
android 获取刘海高度,Android各厂商的刘海屏高度获取工具类
weixin_35171603的博客
05-25 1176
public final classNotchScreenUtil {/*** 华为start*///判断是否是华为刘海屏public static booleanhasNotchInScreenAtHuawei(Context context) {boolean ret = false;try{ClassLoader cl=context.getClassLoader();Class> H...
Android 刘海屏适配总结(推荐)
08-27
Android 刘海屏适配总结 ...刘海屏适配是 Android 应用程序的必要一步，通过设置屏幕高宽比例和应用支持 resizeable，可以告诉系统，我们应用已经适配了刘海屏，并且可以避免刘海屏手机上的 UI 显示问题。
安卓刘海屏适配（测试机型：小米8、华为p20、vivo X21、oppo R15）
07-24
安卓刘海手机适配 1、有状态栏app（也就是不需要全屏的app）无需适配 2、无状态栏全屏显示的app 需要进行刘海屏的适配 博客地址：https://blog.csdn.net/xiaoqiang_0719/article/details/80844519
Android全面屏与异形(刘海)屏的适配教程
08-27
不过，值得注意的是，不同的手机厂商可能有自己的API和解决方案来处理全面屏和刘海屏的适配。例如，OPPO、VIVO和华为等厂商都有自己的开发文档，开发者需要根据具体厂商的文档进行适配。对于OPPO，可以在其开放平台...
Android刘海屏、水滴屏全面屏最佳适配方案
最新发布
2401_83817916的博客
03-24 1192
使用起来很简单：// 支持显示到刘海区域// 获取刘海屏信息@Override});获取刘海区域信息后就可以根据自己应用的需要，来避开重要的控件。详情可参考我项目中的代码。我将适配方案整理后，封装成了一个库并上传至github，可参考使用先自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。
android 获取刘海高度,不同刘海屏幕获取安全高度
weixin_42626599的博客
05-25 1444
系统获取大于等于9.0才有decorView.rootWindowInsets?.displayCutout.safeInsetTop (kotlin)华为判断val cl: ClassLoader = context!!.classLoaderval HwNotchSizeUtil: Class = cl.loadClass("com.huawei.android.util.HwNotchSi...
android 刘海屏幕适配
11-14
android 刘海屏幕适配
Android刘海屏、水滴屏全面屏适配小结
01-20
现在，市面上的屏幕尺寸和全面屏方案五花八门。这里我使用了小米的图来说明： 上述两种屏幕都可以统称为刘海屏，不过对于右侧较小的刘海，业界一般称为水滴屏或美人尖。为便于说明，后文提到的「刘海屏」「刘海区」都同时指代上图两种屏幕。 刘海屏、水滴屏全面屏适配细节 当我们在谈屏幕适配时，我们具体谈什么呢？ 适应更长的屏幕 防止内容被刘海遮挡 其中第一点是所有应用都需要适配的，对应下文的声明最大长宽比，而第二点，如果应用本身不需要全屏显示或使用沉浸式状态栏，是不需要适配的。 针对需要适配第二点的应用，需要获取刘海的位置和宽高，然后将显示内容避开即可。 声明最大长宽比 以前的普通屏长宽比为16
Android中获取状态栏高度的两种方法分享
08-31
在android应用中，有时需要计算个View的位置，导致需要计算状态栏高度。为以后方便，在此做个简单记录。下面这篇文章主要介绍了Android中获取状态栏高度的两种方法，两种方法分别给出了示例代码，有需要的朋友可以参考借鉴。
Android ios Notch,Notch DIY
weixin_26899659的博客
05-28 406
这是一款很不错的个性化的手机壁纸哦，那就是：Notch DIY。在这款软件中，我们可以按照自己的喜好自己定制一款与众不同的壁纸哦，喜欢这款软件的用户还在等什么呀，那就快点下载吧~Notch DIY详细介绍：1、它是一款非常功能强大的壁纸专用工具，大量壁纸资源在线一应俱全任你选择，各种各样设计风格常有专业的系统分区，或是你可以选择自定，充分发挥出你的艺术创意来制作全新升级的壁纸。2、很多模板免费在线...
vivo客户端：全机型UI适配方案
chuyouyinghe的专栏
11-14 507
回首方案，我们这里做到的是使用全屏模式去适配不同机型，更多的适用于像京东、淘宝、商城等电商类APP上，实际上，现在有些非APP会采用分栏的形式做适配，这也是一种跟用户交互的方式，本方案没有提到分栏，后续分栏落地后，对这部分会再进行补充。当然，这个也要根据自己模块的情况来确定，比如微信，更适合左右屏的分栏模式。折叠屏机型，屏幕可旋转，但是宽高比基本是1:1，高度和直板机器基本差不多，可以达到2000px的像素，所以在纵向上，也可以最大限度地展示比较多的内容，比如下图中的模块1、模块2、 模块3的图片。
Android刘海屏适配库NotchFit一键完美实现刘海适配！！！
wcl9900的博客
11-08 1521
    NotchFit是Android端的刘海适配库。该库使用简单，刘海参数智能判断，使开发者无需再考虑手机系统和制造厂商的差异，一键智能刘海参数回调。你值得拥有！！！ 下面对全屏刘海适配做个简要说明： 库引入： compile 'com.wcl.notchfit:notchfit:1.3' 代码实现方式： NotchFit.fit(this, NotchScreenType.FU...
Android P 刘海屏适配全攻略
qq_53058639的博客
01-07 933
Google将刘海屏命名为屏幕缺口了，这一小节内容摘自Android官方介绍：屏幕缺口支持。Android P 支持最新的全面屏以及为摄像头和扬声器预留空间的凹口屏幕。通过全新的类，可以确定非功能区域的位置和形状，这些区域不应显示内容。要确定这些凹口屏幕区域是否存在及其位置，请使用函数。全新的窗口布局属性让您的应用可以为设备凹口屏幕周围的内容进行布局。您可以按如下方法在任何运行 Android P 的设备或模拟器上模拟屏幕缺口：1.启用开发者选项。2.在。
Android 9.0系统新特性，对刘海屏设备进行适配
JiangWeiHu的博客
04-16 359
本文同步发表于我的微信公众号，扫一扫文章底部的二维码或在微信搜索 郭霖 即可关注，每个工作日都有文章更新。 其实Android 9.0系统已经是去...
Android刘海屏适配全方案（华为、小米、Vivo、Oppo)
yangjunjin的博客
02-01 3670
前言 目前市面上的刘海屏和水滴屏手机越来越多了，颜值方面是因人而异，有的人觉得很好看，也有人觉得丑爆了，我个人觉得是还可以。但是作为移动开发者来说，这并不是一件好事，越来越多异形屏手机的出现意味着我们需要投入大量精力在适配上（就不提之后会出的折叠屏手机了）。本文总结了当下主流手机的刘海屏适配方案，鉴于目前Android碎片化的情况，想要覆盖所有的机型是不可能的，但是能适配一些是一些，总比什么都不做要好。 所谓刘海屏，指的是手机屏幕正上方由于追求极致边框而采用的一种手机解决方案。因形似刘海儿而得名——来自
Android刘海屏适配全解析与解决方案
Android刘海屏适配总结是针对Android系统中由于iPhone X引领的刘海屏设计潮流而进行的一系列UI调整和兼容性的处理。随着越来越多的手机厂商采用刘海屏设计，确保刘海屏设备用户的使用体验变得至关重要。本文将深入...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值