API处理Android安全距离详情

前言

在Android屏幕的空间中，大部分的区域我们都是可以随意绘制，只有一部分区域是显示的固定内容：

• 状态栏
• 栏(ActionBar)
• 页面内容(Content)
• 导航栏

其中栏是可选的，除了Material风格的应用应用的并不多，页面内容就是android.R.id.content是Activity的主要内容。

而我们主要需要讨论的就是 状态栏和导航栏，因为这两个区域在不同设备类型，不同的Android版本和不同的厂商下大小和效果是不同的，等等。这些差异无疑增加了我们做页面适配的复杂程度，也更容易出现兼容问题。

在2017年下半年iPhone X的发布，引入了刘海屏设备，导致了蓝绿大厂争相效仿，同时又自成一派，颇有一番百家争鸣之象。 这也导致了一个新的问题 刘海区域适配 ，那时候Android才8.1，并没有API来支持这屏幕上这多出来的一块区域，不过好在大部分设备在定制时刘海和状态栏高度是一致的。

终于在2018年发布的Android 9中Google正式支持了刘海屏，定制了规范约束了设备厂商，减轻了刘海屏适配的差异问题，但是根源问题并没有解决。因为刘海区域的存在，可能会出现页面内容被遮挡，比如：启用页广告跳过按钮被遮挡的问题，导致被应用商店拒掉的风险。

不过好在Android 9中要求刘海设备必须有以下行为：

• 一条边缘最多只能包含一个刘海。
• 一台设备不能有两个以上的刘海。
• 设备的两条较长边缘上不能有刘海。
• 在未设置特殊标志的竖屏模式下，状态栏的高度必须与刘海的高度持平。
• 默认情况下，在全屏模式或横屏模式下，整个刘海区域必须显示黑边。

刘海高度默认是和状态栏高度一致依旧没有变，所以问题又回到了状态栏区域的处理。

描述

所以肯定有同学说了：直接获取状态栏高度不就可以了适配刘海屏了。像这样：

val top = context.getStatusBarHeight()
titleBar.setPadding(0, top, 0, 0)

这么说也没有错，大部分情况下是没有问题的。但是既然官方已经适配刘海屏了，也为我们提供了新的API为什么不用呢：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
    window.decorView.post {
        val top = window.decorView.rootWindowInsets?.displayCutout?.safeInsetTop ?: 0
        // val bottom = window.decorView.rootWindowInsets?.displayCutout?.safeInsetBottom ?: 0
        titleBar.setPadding(0, top, 0, 0)
    }
}

上面的方案实际上可以获取上下左右四个方向的安全距离，但大部分情况我们只需要处理顶部就可以了。实际上这已经可以解决我们的问题了，但是还有更好的解决方案方案：

添加依赖：

implementation 'androidx.core:core:1.7.0'

// 老版本也可以，但是getInsets() API 还没添加
// implementation 'androidx.core:core:1.3.0'

使用ViewCompat工具：

ViewCompat.setOnApplyWindowInsetsListener(titleBar) { view: View, insets: WindowInsetsCompat ->
    //val top = insets.systemWindowInsetTop // 高版本已经过时，可以用下面的api替换
    val stableInsets = insets.getInsets(
    WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout())
    titleBar.setPadding(0, stableInsets.top, 0, 0)
    return@setOnApplyWindowInsetsListener insets
}

实际上屏幕安全距离，基本上全部围绕这一个API，Google也推荐我们这么做，在很多系统控件都能看到它的影子，比如：AppBarLayout、DrawerLayout、NavigationBarView等等都有用到，内部都是来处理系统安全距离的。

系统栏适配

上面提到了手机有各种系统栏（状态栏、导航栏），如果一个全屏+刘海屏+透明系统栏+屏幕旋转的页面处理这些安全距离就更复杂，比如短视频页，这里先给大家列几条可能出现的问题：

• 没有导航栏或者可以动态隐藏导航栏的设备
• 导航栏不会旋转的设备（就是导航栏一直在屏幕的一个边，不会跟随屏幕旋转）
• 导航栏跟随屏幕旋转的设备（主要是手势导航的设备和一些平板上）
• 刘海在屏幕底部的设备（开发者选项可以开启双刘海模式，设备两个短边都有刘海）
• 底部刘海+导航栏一起显示的设备
• ... ...

这些所有的问题通过 ViewCompat.setOnApplyWindowInsetsListener() 来优雅处理， 通过 WindowInsetsCompat.getInsets(type) 可以获取系统的各个栏的大小， 我们也可以同时获取多个系统栏的高度，各个距离内部会进行累加，返回一个类似Rect的对象，对应屏幕的左上右下需要插入的距离：

val stableInsets = insets.getInsets(
    WindowInsetsCompat.Type.statusBars() or
    WindowInsetsCompat.Type.navigationBars() or
    WindowInsetsCompat.Type.displayCutout())

然后在对不同位置的控件添加对应的边距。除了上面提到的三种类型的安全距离，还有一些其他的类型，有兴趣的可以自己了解。

其他适配

ViewCompat.setOnApplyWindowInsetsListener()能解决大部分安全距离的问题，但是有一点它是处理不了的，就是 屏幕圆角，这些安全距离的计算是不处理屏幕圆角的，所以如果有圆角要处理那我们就要另辟蹊径了。

好在Android 12中官方添加了对圆角的支持：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    val roundedCorner = insets.toWindowInsets()
        ?.getRoundedCorner(RoundedCorner.POSITION_TOP_LEFT)
    roundedCorner?.center
}

我用了Pixel4真机发现能获取到数据，但是模拟器获取不到。

除了圆角支持，还有对隐私指示器提供了支持：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    val rect = insets.toWindowInsets()?.privacyIndicatorBounds
    // 页面控件需要避开这个区域，不然可能会被遮挡
}

隐私指示器的范围，主要是 摄像头和麦克风 使用中状态的指示器边界，如果是录制直播或者相机的页面需要处理这个区域。

除了圆角以外，好像没有找到官方对打孔屏的支持，可能后面会加入对打孔屏的支持吧。

到此这篇关于API处理Android安全距离详情的文章就介绍到这了,更多相关 Android安全距离内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！