You need to enable JavaScript to run this app. Android 10及以上如何获取底部导航按钮可见状态以适配全屏
优惠活动
大模型
产品
解决方案
定价
更多

Android 10及以上如何获取底部导航按钮可见状态以适配全屏

Android 10及以上版本检测系统底部导航按钮可见状态的实现方案

核心判断逻辑

Android 10(API 29)开始,系统通过WindowInsets机制统一传递所有会遮挡应用显示区域的系统UI参数,这是目前跨厂商兼容最稳定的判断方案,不需要依赖反射、系统属性读取这类不稳定的实现:

  • 核心判定依据来自导航栏类型对应的inset值:当应用处于绘制到系统栏后方的沉浸模式时,系统会把实际被导航UI占用的底部高度通过inset回调传递给应用
  • 基础判定规则:
    • 若底部导航栏对应的inset值处于42-56dp区间,可判定为三键导航按钮处于可见状态
    • 若底部inset值为0,或仅为20-28dp的手势提示线高度,可判定为三键导航按钮已隐藏(即用户切换为全面屏手势模式)

核心实现代码

在Activity的根布局上注册Insets回调,即可实时拿到导航栏的状态变化(包含用户手动切换导航模式时的动态更新):

// 开启绘制到系统栏后方的沉浸模式
WindowCompat.setDecorFitsSystemWindows(window, false)

// 给根布局注册Insets监听
binding.root.setOnApplyWindowInsetsListener { view, windowInsets ->
    // 获取导航栏类别对应的底部inset值(单位px)
    val navBarBottomInset = windowInsets
        .getInsets(WindowInsets.Type.navigationBars())
        .bottom
    // 转换为dp单位做阈值判断
    val density = resources.displayMetrics.density
    val navBarBottomInsetDp = navBarBottomInset / density

    // 判断三键导航是否可见:高度阈值设为36dp,区分三键(>36dp)和手势提示线(<36dp)
    val isThreeButtonNavVisible = navBarBottomInsetDp > 36

    // 根据状态动态调整应用内边距,避免内容被遮挡
    view.updatePadding(
        bottom = if (isThreeButtonNavVisible) navBarBottomInset else 0
    )
    WindowInsets.CONSUMED
}

兼容注意事项

  • 不要依赖反射读取系统设置中的navigation_mode属性判断状态:国内定制系统(尤其是MIUI、ColorOS)对该属性的赋值逻辑不统一,经常出现用户已经切换为手势导航、但属性值仍标记为三键模式的误判情况
  • 针对Android 11及以上版本,可直接调用windowInsets.isVisible(WindowInsets.Type.navigationBars())获取导航栏的可见状态,比高度值判断更准确;Android 10版本由于没有该API,可沿用上述高度阈值的判断逻辑
  • 用户手动切换三键/手势导航模式时,系统会主动重新分发WindowInsets,不需要额外监听系统设置变化,上述回调会自动收到最新的状态值

全屏可用性判定

  • 当检测到三键导航按钮不可见(即导航栏inset值小于36dp或为0)时,即可判定当前无常驻系统按钮遮挡,满足完全全屏的显示条件
  • 当检测到三键导航按钮可见时,给应用核心交互区域预留对应高度的底部内边距,避免列表、按钮被导航栏遮挡

内容的提问来源于stack exchange,提问作者Shan Ahmad

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 20:24:03