Scrcpy项目在Android 15上创建虚拟显示失败的技术分析

问题背景

Scrcpy作为一款流行的开源Android屏幕镜像工具，近期在Google Pixel 9 Pro XL设备上运行Android 15系统时，用户报告无法创建新的虚拟显示。错误日志显示系统抛出了"Requires ADD_TRUSTED_DISPLAY permission"的安全异常，这直接导致屏幕镜像功能失效。

技术细节解析

虚拟显示创建机制

Scrcpy的核心功能依赖于Android系统的虚拟显示API。当使用--new-display参数时，工具会尝试创建一个独立的虚拟显示设备，而不是镜像主屏幕。这个功能通过以下调用链实现：

1. 调用DisplayManager.createVirtualDisplay()
2. 底层通过IDisplayManager Binder接口与系统服务通信
3. DisplayManagerService执行实际的虚拟显示创建

Android 15的权限变更

在Android 15中，Google引入了新的安全限制。创建"可信虚拟显示"现在需要特殊的ADD_TRUSTED_DISPLAY权限，这个权限属于系统级权限，普通应用无法获取。错误堆栈显示：

SecurityException: Requires ADD_TRUSTED_DISPLAY permission to create a trusted virtual display

这表明Android 15对虚拟显示的分类更加严格，将Scrcpy尝试创建的显示归类为"可信显示"，从而触发了权限检查。

影响范围

此问题特定于：

• 运行Android 15的设备
• 使用--new-display参数的情况
• 特别是Google Pixel系列新机型

标准屏幕镜像模式(不创建新显示)不受此影响。

解决方案

根据开发团队确认，此问题已在Android 16 Beta 3中得到修复。可能的修复方向包括：

1. 调整虚拟显示的分类标准
2. 放宽对特定类型虚拟显示的权限要求
3. 提供替代API供屏幕镜像类应用使用

开发者建议

对于需要立即使用的开发者，可以考虑以下临时方案：

1. 不使用--new-display参数，改用标准镜像模式
2. 降级到Android 14系统
3. 等待Android 16正式版发布

技术启示

这个案例展示了Android系统在安全性和功能性之间的平衡挑战。随着Android系统日趋成熟，Google正在收紧各类系统级操作的权限控制，这要求工具开发者需要：

1. 密切关注各版本Android的行为变更
2. 提前适配即将到来的权限模型变化
3. 为关键功能准备备用实现方案

对于Android工具开发者而言，建立完善的版本兼容性测试体系变得愈发重要。