如何检测Android设备当前启用手势导航还是按键导航？

一、官方可用方法 #

Android 10及以上系统，可通过两种方式判断手势导航模式：

1. 基于导航栏高度阈值判断 #

手势导航模式下，导航栏高度通常远低于经典三键导航的高度。可通过对比当前导航栏高度与系统标准导航栏高度来判断：

fun isGestureNavigation(context: Context, view: View): Boolean {
    val insets = ViewCompat.getRootWindowInsets(view) ?: return false
    // 获取当前导航栏底部高度
    val currentNavHeight = insets.getInsets(WindowInsets.Type.navigationBars()).bottom
    // 获取系统标准导航栏高度
    val standardNavResId = context.resources.getIdentifier("navigation_bar_height", "dimen", "android")
    val standardNavHeight = if (standardNavResId > 0) context.resources.getDimensionPixelSize(standardNavResId) else 0
    // 手势导航下高度通常为标准高度的60%以下，可根据实际测试调整阈值
    return standardNavHeight > 0 && currentNavHeight < standardNavHeight * 0.6f
}

2. 读取系统隐藏设置（需谨慎使用） #

系统存在隐藏的navigation_mode设置项，0代表经典导航，1代表手势导航，但该字段未公开，可能因厂商ROM或系统版本变更失效：

fun isGestureNavigationBySettings(context: Context): Boolean {
    return try {
        val mode = Settings.Secure.getInt(context.contentResolver, "navigation_mode", 0)
        mode == 1
    } catch (e: Settings.SettingNotFoundException) {
        false
    }
}

二、替代兼容方案 #

若上述方法存在兼容性问题，可通过监听窗口内边距变化实时判断：

// 在Activity或Fragment中设置监听
window.decorView.setOnApplyWindowInsetsListener { view, insets ->
    val currentNavHeight = insets.getInsets(WindowInsets.Type.navigationBars()).bottom
    val standardNavResId = resources.getIdentifier("navigation_bar_height", "dimen", "android")
    val standardNavHeight = if (standardNavResId > 0) resources.getDimensionPixelSize(standardNavResId) else 0
    val isGesture = standardNavHeight > 0 && currentNavHeight < standardNavHeight * 0.6f
    // 此处可根据isGesture值调整UI布局
    view.onApplyWindowInsets(insets)
}

三、注意事项 #

• 不同厂商ROM对导航模式的实现有差异，需针对主流品牌（如小米、华为、OPPO等）做适配测试，调整高度阈值。
• Android 12及以上支持全屏手势模式（导航栏隐藏），需结合insets.isVisible(WindowInsets.Type.navigationBars())补充判断。
• 优先使用基于导航栏高度的方法，避免依赖非公开API导致后续版本兼容问题。

内容的提问来源于stack exchange，提问作者Aaydin