解决ws-scrcpy在Android 15上的屏幕显示问题

在Android 15设备上使用ws-scrcpy时，用户可能会遇到屏幕无法显示但设备仍可控制的问题。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题背景

ws-scrcpy是基于scrcpy的WebSocket实现版本，用于通过网络连接远程控制Android设备。随着Android 15的发布，部分API发生了变化，导致原有的屏幕捕获机制失效。

根本原因分析

问题主要源于Android 15中对SurfaceControl API的修改：

1. SurfaceControl.createDisplay方法在Android 15中已被弃用
2. 新的VirtualDisplay API需要适配
3. 剪贴板监听接口也发生了变化

解决方案

方法一：使用预编译的修复版本

开发社区已经提供了修复后的scrcpy-server.jar文件，可以直接替换使用。这个版本主要做了以下改进：

1. 将SurfaceControl替换为VirtualDisplay实现
2. 适配了新的剪贴板监听接口
3. 保持与Android 14/15的兼容性

方法二：自行编译修改版

如需自定义功能，可以基于NetrisTV/scrcpy的1.19分支进行修改，主要修改点包括：

1. 显示相关代码：

// 替换SurfaceControl为VirtualDisplay实现
DisplayManager dm = (DisplayManager) context.getSystemService(Context.DISPLAY_SERVICE);
VirtualDisplay virtualDisplay = dm.createVirtualDisplay(...);

2. 剪贴板监听适配：

// 适配新的剪贴板监听接口
clipboardManager.addPrimaryClipChangedListener(newClipListener, packageName, userId);

使用注意事项

1. 替换scrcpy-server.jar后，建议重启设备和电脑
2. 在ws-scrcpy界面中选择"H264 Converter"选项
3. 部分设备可能需要多次尝试才能正常工作

技术展望

随着Android系统的持续更新，显示和输入相关的API可能会进一步变化。建议开发者：

1. 关注Android官方API变更日志
2. 及时更新依赖库版本
3. 考虑使用更稳定的抽象层来隔离系统API变化

通过上述解决方案，用户可以在Android 15设备上正常使用ws-scrcpy的全部功能，包括屏幕显示和设备控制。