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
相关产品推荐
相关产品推荐

