Sunshine项目中AMD显卡在Wayland下鼠标光标捕获问题分析

问题背景

在Sunshine游戏串流项目中，用户反馈在Ubuntu 24.04 LTS系统上使用Wayland显示服务器时，通过Moonlight客户端无法看到主机端的鼠标光标。该问题仅在开启屏幕录制功能时才能暂时解决。经过分析，这是一个与AMD显卡驱动和显示协议相关的技术问题。

技术分析

硬件环境

问题出现在使用AMD Turks PRO显卡（Radeon HD 6570/7570/8550系列）的系统上，该显卡使用的是开源的radeon驱动。日志显示系统检测到该驱动不支持原子模式设置(atomic mode-setting)，这是导致光标捕获失败的根本原因。

显示协议差异

Wayland作为新一代显示服务器协议，与传统的X11在图形处理方式上有显著差异。在Wayland环境下，Sunshine需要通过KMS/DRM API来捕获显示内容，包括鼠标光标。而radeon驱动缺乏对原子模式设置的支持，导致无法正确捕获光标平面。

日志关键信息

系统日志中明确提示：

GPU driver doesn't support atomic mode-setting
Cursor capture may fail without atomic mode-setting support
No KMS cursor plane found

这些警告信息直接指出了问题的技术根源。

解决方案

临时解决方案

1. 切换到X11显示服务器：在登录界面选择X11会话而非Wayland，这可以绕过Wayland下的光标捕获问题。
2. 启用屏幕录制：虽然不理想，但可以临时解决光标可见性问题。
3. 禁用硬件光标：通过系统设置禁用硬件加速的光标渲染。

长期解决方案

1. 升级硬件：考虑升级到支持原子模式设置的AMD显卡，如使用amdgpu驱动的较新型号。
2. 等待Pipewire支持：Sunshine项目正在开发基于Pipewire的捕获方案，这将提供不依赖KMS/DRM的光标捕获能力。
3. 驱动更新：关注radeon驱动的后续更新，看是否会添加原子模式设置支持。

技术建议

对于使用老旧AMD显卡的用户，建议：

1. 评估硬件升级的必要性，现代显卡能提供更好的性能和兼容性
2. 如果必须使用当前硬件，暂时切换到X11环境是更稳定的解决方案
3. 关注Sunshine项目的更新日志，特别是Pipewire集成进展

该问题反映了老旧硬件在新软件环境下的兼容性挑战，也展示了开源项目在应对多样化硬件配置时的技术挑战。随着Sunshine项目的持续开发，这类问题有望得到更完善的解决方案。