Android Accessibility Service Overlay遮挡导航按钮问题求助

我之前在做无障碍服务的悬浮层时也踩过这个坑，折腾了好一阵才找到可行的解决办法，给你几个方向试试：

1. 避开导航栏区域：动态设置边距 #

最直接的思路就是让你的Overlay视图主动避开系统导航栏的位置，这需要先获取导航栏的高度，再给视图设置对应的底部边距。

获取导航栏高度 #

可以通过系统资源获取默认的导航栏高度：

private fun getNavigationBarHeight(context: Context): Int {
    val resources = context.resources
    val navBarHeightId = resources.getIdentifier("navigation_bar_height", "dimen", "android")
    return if (navBarHeightId > 0) {
        resources.getDimensionPixelSize(navBarHeightId)
    } else {
        0
    }
}

配置WindowManager参数 #

在创建Overlay的布局参数时，把底部边距设置为导航栏高度，同时注意不要使用会让视图全屏延伸的flag：

val overlayParams = WindowManager.LayoutParams(
    WindowManager.LayoutParams.MATCH_PARENT,
    WindowManager.LayoutParams.WRAP_CONTENT,
    // 适配不同API级别，Android 10+优先用TYPE_ACCESSIBILITY_OVERLAY
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        WindowManager.LayoutParams.TYPE_ACCESSIBILITY_OVERLAY
    } else {
        WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY
    },
    // 不要加FLAG_LAYOUT_NO_LIMITS，避免覆盖系统栏
    WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE or WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN,
    PixelFormat.TRANSLUCENT
).apply {
    gravity = Gravity.TOP or Gravity.CENTER_HORIZONTAL
    // 设置底部边距，让视图避开导航栏
    bottomMargin = getNavigationBarHeight(context)
}

2. 用WindowInsets动态适配（推荐） #

如果你的设备支持手势导航或者导航栏会动态显示/隐藏，上面的固定边距可能不够灵活，这时候可以用WindowInsets来实时适配：

yourOverlayView.setOnApplyWindowInsetsListener { view, insets ->
    // 获取导航栏的Insets
    val navBarInsets = insets.getInsets(WindowInsets.Type.navigationBars())
    // 更新视图的底部边距
    view.updateLayoutParams<ViewGroup.MarginLayoutParams> {
        bottomMargin = navBarInsets.bottom
    }
    // 返回处理后的Insets
    insets.consumeSystemWindowInsets()
}

这种方式能自动监听导航栏的状态变化，随时调整视图位置，适配各种屏幕情况。

3. 检查WindowManager的Flags #

一定要确保你没有设置FLAG_LAYOUT_NO_LIMITS这个flag——它会让视图忽略所有系统窗口的限制，直接延伸到屏幕边缘，包括导航栏区域。如果之前加了这个flag，赶紧换成FLAG_LAYOUT_IN_SCREEN，它会让视图在屏幕范围内布局，但不会强制覆盖系统栏。

你可以先试试第一种方法，大部分场景下都能解决问题，如果是动态导航栏的情况，再用第二种方法适配。

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