解决scrcpy在Xiaomi Android 14设备上显示颜色异常问题

问题现象

近期有用户报告，在使用scrcpy工具连接Xiaomi Android 14设备时，屏幕镜像中浅灰色显示为纯白色，而其他工具如Android Studio和adb screencapture则能正确显示颜色。这一问题在设备升级到Android 14后出现，而在Google Pixel 6（同样运行Android 14）上则不会发生。

问题分析

经过技术团队深入调查，发现问题的根源在于视频编码的色彩范围设置。现代Android设备在视频编码时可能使用两种不同的色彩范围：

1. 有限范围（Limited Range）：Y值16-235，Cb/Cr值16-240
2. 全范围（Full Range）：Y/Cb/Cr值0-255

Xiaomi的部分Android 14设备默认使用全范围色彩编码，而scrcpy的SDL渲染器默认按照有限范围进行解码和显示，导致颜色映射错误，特别是浅灰色区域被错误地映射为纯白色。

解决方案

临时解决方案

对于需要立即解决问题的用户，可以通过以下命令行参数强制指定色彩范围：

scrcpy --video-codec-options=color-range=2

此参数明确告诉编码器使用有限色彩范围（值为2表示有限范围，1表示全范围）。

永久解决方案

scrcpy开发团队已经实施了双重修复方案：

1. 渲染器修复：在显示层添加了对全范围色彩的支持，通过检测帧的色彩范围并动态调整SDL的YUV转换模式。

2. 编码器默认设置：修改服务器端代码，默认请求编码器使用有限色彩范围（除非用户明确指定全范围）。这通过设置MediaFormat的COLOR_RANGE_LIMITED参数实现。

技术细节

对于开发者而言，值得注意的技术要点包括：

• Android MediaCodec API从Android N（API 24）开始支持显式设置色彩范围
• SDL提供SDL_SetYUVConversionMode()函数来调整YUV到RGB的转换方式
• 全范围色彩更适合计算机图形，而有限范围则是视频内容的传统标准
• 不同渲染后端（OpenGL、OpenGL ES 2.0、软件渲染）对色彩范围的处理可能存在差异

兼容性考虑

修复方案充分考虑了不同设备和Android版本的兼容性：

• 对于不支持色彩范围设置的旧设备，保持原有行为
• 用户仍可通过参数强制使用全范围色彩（如需要）
• 方案经过测试验证在多种Xiaomi设备上的有效性

结论

这一问题的解决展示了scrcpy团队对设备兼容性的持续关注。通过同时修改编码器和渲染器的处理逻辑，确保了在各种设备上都能获得准确的色彩显示。用户只需更新到最新版本的scrcpy即可自动获得修复，无需额外配置。

对于高级用户，仍然保留了通过参数控制色彩范围的能力，以满足特殊使用场景的需求。这一改进进一步提升了scrcpy作为Android设备屏幕镜像工具的可靠性和用户体验。