解决scrcpy在PICO 4 Ultra设备上的兼容性问题

问题背景

scrcpy是一款流行的Android设备屏幕镜像工具，但在某些特定设备上可能会遇到兼容性问题。近期在PICO 4 Ultra设备上使用scrcpy 3.1版本时，用户报告了无法正常启动的问题，同时发现2.7版本虽然能运行但crop参数无法正常工作。

问题分析

通过错误日志分析，发现问题的根源在于PICO设备厂商对Android系统进行了定制修改，特别是在DisplayManagerGlobal.getDisplayInfoLocked()方法中添加了自定义实现。具体表现为：

1. 设备厂商添加了对ExtDisplayManagerGlobalImpl.adjustDisplayInfo()的调用
2. 该方法尝试读取Configuration对象中的windowConfiguration字段
3. 当Configuration对象为null时，会导致NullPointerException异常

解决方案

经过深入研究，开发团队提出了两种解决方案：

方案一：初始化Configuration对象

第一种尝试是为ActivityThread设置一个空的Configuration对象：

Field configurationField = configurationControllerClass.getDeclaredField("mConfiguration");
configurationField.setAccessible(true);
configurationField.set(configurationController, new Configuration());

但这种方法会导致视频尺寸变为0x0，无法满足需求。

方案二：设置系统线程标志

更有效的解决方案是通过反射将ActivityThread的mSystemThread标志设置为true：

Field mSystemThreadField = ACTIVITY_THREAD_CLASS.getDeclaredField("mSystemThread");
mSystemThreadField.setAccessible(true);
mSystemThreadField.setBoolean(ACTIVITY_THREAD, true);

这种方法巧妙地绕过了厂商的定制代码，因为厂商代码中有如下判断逻辑：

if (displayId != 0 || ActivityThread.isSystem() || ...)

通过设置mSystemThread为true，使得ActivityThread.isSystem()返回true，从而跳过厂商的定制逻辑。

使用注意事项

1. 在PICO设备上使用crop参数时，需要注意不同显示ID的效果差异
2. 可以通过scrcpy --list-displays命令查看可用显示列表
3. PICO设备在镜像时通常会显示多个虚拟显示，包括主显示(4320x2160)和其他辅助显示

技术启示

这个案例展示了Android设备碎片化带来的兼容性挑战，以及如何通过深入分析系统源码和反射机制来解决特定厂商定制带来的问题。同时也提醒开发者：

1. 厂商定制可能会影响标准API的行为
2. 反射机制是解决兼容性问题的有力工具
3. 理解系统内部工作原理对于调试复杂问题至关重要

该解决方案已被合并到scrcpy的开发分支中，未来版本将包含这一修复。