API处理Android安全距离详情

 更新时间:2022年06月15日 11:29:54   作者:​ de得得de   ​  
这篇文章主要介绍了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安全距离内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Android简单的短信验证功能的实现代码

    Android简单的短信验证功能的实现代码

    这篇文章主要介绍了Android简单的短信验证功能的实现代码,本文是小编使用sdk过程的一些心得,需要的朋友可以参考下
    2018-07-07
  • 基于Android的服务器端程序实例

    基于Android的服务器端程序实例

    这篇文章主要介绍了基于Android的服务器端程序实例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03
  • Flutter组件开发过程完整讲解

    Flutter组件开发过程完整讲解

    这篇文章主要介绍了Flutter组件开发过程,Flutter是Google开源的构建用户界面(UI)工具包,帮助开发者通过一套代码库高效构建多平台精美应用,支持移动、Web、桌面和嵌入式平台。Flutter 开源、免费,拥有宽松的开源协议,适合商业项目
    2022-11-11
  • Android自定义View实现loading动画加载效果

    Android自定义View实现loading动画加载效果

    项目开发中对Loading的处理是比较常见的,安卓系统提供的不太美观,引入第三发又太麻烦,这时候自己定义View来实现这个效果。这篇文章主要介绍了Android自定义View实现loading动画加载效果,需要的朋友可以参考下
    2017-03-03
  • Android Socket通信详解

    Android Socket通信详解

    这篇文章主要介绍了Android Socket通信详解的相关资料,需要的朋友可以参考下
    2015-12-12
  • 微信小程序电商常用倒计时实现实例

    微信小程序电商常用倒计时实现实例

    这篇文章主要介绍了微信小程序电商常用倒计时实现实例的相关资料,需要的朋友可以参考下
    2017-06-06
  • OpenGL Shader实例分析(4)闪光效果

    OpenGL Shader实例分析(4)闪光效果

    这篇文章主要为大家详细介绍了OpenGL Shader实例分析第4篇,实现闪光效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-02-02
  • Flutter实现可以缩放拖拽的图片示例代码

    Flutter实现可以缩放拖拽的图片示例代码

    这篇文章主要给大家介绍了关于利用Flutter实现可以缩放拖拽的图片的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Flutter具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
    2019-06-06
  • 详解Android的Handler机制原理

    详解Android的Handler机制原理

    Android的Handler机制是一种用于处理和调度线程之间消息传递的机制,通常用于在后台线程中执行任务,并将结果返回到主线程中更新UI,Handler机制的核心是Message和MessageQueue,以及Looper,本文给大家详细讲解了Android的Handler机制原理,需要的朋友可以参考下
    2023-10-10
  • android中使用Activity实现监听手指上下左右滑动

    android中使用Activity实现监听手指上下左右滑动

    这篇文章主要介绍了android中使用Activity实现监听手指上下左右滑动,本文使用了Activity的ontouchEvent方法监听手指点击事件,并给出代码实例,需要的朋友可以参考下
    2015-05-05

最新评论