Termux-X11项目中模拟触屏模式下的坐标偏移问题分析

Termux-X11项目中模拟触屏模式下的坐标偏移问题分析

termux-x11 Termux X11 add-on application. Still in early development. 项目地址: https://gitcode.com/gh_mirrors/te/termux-x11

在Termux-X11项目的使用过程中，当用户开启软键盘并切换至"Simulated touchscreen"（模拟触屏）输入模式时，可能会遇到触摸坐标与实际光标位置不匹配的问题。本文将深入分析该问题的成因及解决方案。

问题现象

用户报告在以下特定场景会出现坐标偏移：

1. 输入模式设置为"Simulated touchscreen"
2. 启用Reseed功能
3. 软键盘处于开启状态

此时，用户触摸屏幕时，系统模拟的触摸点与实际显示位置存在明显偏差。从用户提供的屏幕录像可以观察到，当软键盘关闭后，触摸事件的坐标转换出现错误。

技术分析

经过开发者调查，发现问题根源在于显示分辨率模式和视图回调机制：

1. 分辨率模式影响：

   • 当使用custom/exact（自定义/精确）分辨率模式时，LorieView会保持固定宽高比进行缩放
   • 在native/scaled（原生/缩放）分辨率模式下，LorieView会拉伸以适应屏幕

2. 回调机制失效：

   • 关键问题在于软键盘切换时，LorieView.mSurfaceCallback.surfaceChanged()回调未被触发
   • 由于表面(surface)尺寸未改变，系统未自动更新坐标转换矩阵
   • 导致触摸事件的坐标转换未随显示布局变化而更新

解决方案

开发团队通过以下方式解决了该问题：

1. 手动触发回调：

   • 在软键盘状态变化时，主动调用LorieView.triggerCallback()
   • 强制更新坐标转换矩阵

2. 改进触摸事件处理：

   • 确保在不同显示缩放状态下正确计算触摸坐标
   • 保持触摸事件与显示内容的同步

验证结果

测试表明，该修复方案有效解决了坐标偏移问题。用户在以下场景中验证确认：

• 各种分辨率模式下
• 软键盘开启/关闭状态切换时
• 不同触摸输入模式下

触摸事件现在能够准确反映用户的实际操作位置。

技术启示

该案例揭示了Android开发中一个常见但容易被忽视的问题：当UI布局因软键盘等系统组件发生变化时，开发者需要特别注意手动处理相关的回调更新。特别是在涉及复杂坐标转换的场景中，自动回调机制可能无法覆盖所有边界情况。

Termux-X11项目团队通过这次修复，不仅解决了具体问题，也为类似场景下的开发提供了有价值的参考方案。

termux-x11 Termux X11 add-on application. Still in early development. 项目地址: https://gitcode.com/gh_mirrors/te/termux-x11