Jetpack Compose开启TalkBack时detectTapGestures返回固定偏移问题

问题现象 #

• TalkBack（Android系统屏幕阅读器）关闭状态下，detectTapGestures可正常返回符合预期的onTap、onPress回调对应的点击坐标偏移
• TalkBack开启时，回调返回的偏移值始终为视图中心位置的固定常量
• 复现问题所用Jetpack Compose版本：1.2.0-beta01

复现代码 #

Text(
   modifier = Modifier.pointerInput(Unit) {
           detectTapGestures(
                    onPress = { offset ->
                        Log.d("", "onPress $offset")
                    },
                    onTap = { offset ->
                        Log.d("", "onTap $offset")
                    }
                )
            },
            text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore"
        )

运行表现 #

• TalkBack关闭时，日志输出为随实际点击位置变化的正常坐标值，示例输出：

onPress Offset(151.0, 29.0)
onTap Offset(157.0, 18.0)
onPress Offset(699.0, 62.0)
onPress Offset(391.0, 17.0)
onTap Offset(361.0, -1.0)
onPress Offset(282.0, 85.0)
onPress Offset(729.0, 48.0)
onTap Offset(770.0, 40.0)

• TalkBack开启时，所有回调接收到的坐标均为固定的视图中心值，示例输出：

onTap Offset(540.0, 46.0)
onPress Offset(540.0, 46.0)
onTap Offset(540.0, 46.0)
onPress Offset(540.0, 46.0)
onTap Offset(540.0, 46.0)
onPress Offset(540.0, 46.0)
onTap Offset(540.0, 46.0)
onPress Offset(540.0, 46.0)

排查结论 #

• 开启TalkBack时返回的固定值为对应视图的中心坐标
• 单步调试TapGestureDetector.kt中detectTapGestures实现源码确认：TalkBack开启状态下，waitForUpOrCancellation方法内调用的awaitPointerEvent()会返回固定位置值

核心结论 #

该现象不属于代码缺陷，是TalkBack开启后系统无障碍框架的默认交互逻辑导致的预期行为：

• TalkBack作为系统级无障碍服务，启动后会拦截上层应用的单指触摸事件，将普通单指点击转换为「聚焦选中当前可访问语义节点」的操作，不会把原始触摸点坐标透传给应用的手势检测层，默认以被选中节点的中心坐标作为事件位置下发给上层。
• 调试中看到的awaitPointerEvent()返回固定中心值，本质是原始触摸事件已经被TalkBack消费替换，Compose手势层拿到的是TalkBack重新构造的语义事件，不是原始触摸事件。

规避方案 #

可根据业务场景选择对应方案：

• 普通可点击组件适配：不要直接使用封装完成的detectTapGestures，直接在底层指针事件流中获取坐标，同时手动配置组件的无障碍语义，避免事件被完全拦截，参考实现：

Text(
    modifier = Modifier
        .semantics {
            // 声明组件可点击属性，保证TalkBack可正常识别聚焦、响应点击操作
            onClick {
                // 同步点击业务逻辑，保证无障碍操作下交互一致性
                true
            }
        }
        .pointerInput(Unit) {
            awaitEachGesture {
                // 直接获取原始按下事件坐标
                val downEvent = awaitFirstDown()
                val pressOffset = downEvent.position
                Log.d("", "onPress $pressOffset")
                // 等待抬手事件判断是否为有效点击
                val upEvent = waitForUpOrCancellation()
                if (upEvent != null) {
                    val tapOffset = upEvent.position
                    Log.d("", "onTap $tapOffset")
                    // 执行点击业务逻辑
                }
            }
        },
    text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore"
)

• 强依赖真实触摸坐标的自定义组件适配（如画板、不规则热区点击组件）：在semantics配置中关闭默认的点击事件接管，手动处理无障碍事件分发，同时保留TalkBack基础聚焦、激活能力即可。

补充说明 #

Compose 1.3及之后的稳定版本对无障碍场景下的手势透传做了部分优化，但只要TalkBack处于默认单指浏览模式，普通单指点击依然会返回节点中心坐标——这是移动端无障碍服务的通用设计逻辑：TalkBack下单指点击的语义是「选中控件」而非「点击控件的具体位置」，真实触摸坐标仅在双指透传手势、双击激活手势下会正常返回。

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