scrcpy项目在Android 14上的鼠标输入问题分析与解决方案

问题背景

scrcpy是一款流行的开源Android屏幕镜像工具，它允许用户通过电脑控制Android设备。近期，在三星Galaxy S22 Ultra等设备升级到Android 14后，用户报告了一个特殊问题：当通过scrcpy连接虚拟显示时，鼠标左键点击和滚轮滚动操作失效。

技术现象分析

在Android 14系统中，三星设备表现出以下特殊行为：

1. 显示ID动态创建：当scrcpy连接时，系统会自动创建一个新的显示ID。例如：

   • 原始显示ID：0(主屏幕)和2(DeX显示)
   • scrcpy连接后新增显示ID：80

2. 输入事件路由异常：鼠标点击和滚动事件被路由到新创建的显示ID(如91)，而不是目标虚拟显示ID(如90)。这导致：

   • 键盘输入能正常工作(发送到显示ID 90)
   • 鼠标点击和滚动失效(需要发送到显示ID 91)

3. ADB命令验证：通过ADB命令测试确认：

   adb shell input -d 90 tap 100 800  # 不工作
   adb shell input -d 91 tap 100 800  # 正常工作
   

根本原因

经过深入分析，这个问题源于三星在Android 14中对显示系统的修改：

1. DeX模式整合：三星似乎将DeX模式与虚拟显示/桌面体验进行了深度整合
2. 输入输出分离：系统为虚拟显示创建了两个ID：
   • 一个用于内容输出(如显示ID 90)
   • 另一个专门用于输入事件处理(如显示ID 91)

解决方案实现

针对这一问题，开发者提出了多种解决方案：

1. 临时解决方案：

   • 同时运行两个scrcpy实例：
     • 一个用于显示(--display-id=90)
     • 另一个用于输入(--display-id=91)

2. 代码级修复：

   • 修改Controller.java，为鼠标事件添加专门的显示ID参数
   • 实现新的--add-display-id选项，指定点击/滚动事件的目标显示ID
   • 关键代码修改包括：

     if (addDisplayId > 0) {
         return device.injectEvent(event, addDisplayId, Device.INJECT_MODE_ASYNC);
     } else {
         return device.injectEvent(event, Device.INJECT_MODE_ASYNC);
     }
     

3. 官方修复方案：

   • 项目维护者提出的PR #5370从根本上解决了这一问题
   • 新版本已能正确处理Android 14上的输入事件路由

技术启示

这一案例提供了几个有价值的启示：

1. 厂商定制系统的兼容性挑战：OEM对Android的深度定制可能引入非标准行为
2. 输入输出分离架构：现代显示系统可能采用输入输出分离的设计理念
3. 灵活的问题解决思路：从临时方案到永久修复的渐进式解决过程

用户建议

对于遇到类似问题的用户，建议：

1. 升级到包含PR #5370的最新scrcpy版本
2. 若需使用虚拟显示，命令格式为：

   scrcpy --display-id=<虚拟显示ID>
   

3. 对于特殊场景，可考虑使用--add-display-id参数(在自定义构建中)

这一问题的解决不仅提升了scrcpy在Android 14设备上的兼容性，也为处理类似厂商定制问题提供了宝贵经验。