远程桌面

远程桌面允许管理员直接从 HandyCafe Server 界面实时查看和控制客户端 PC。专为网吧或电竞馆中的故障排查、监控和协助顾客而设计，无需走到机器旁边。

启动远程桌面会话

1. 在管理面板中，找到要连接的客户端。
2. 点击客户端卡片显示操作按钮。
3. 点击远程桌面按钮。

远程桌面查看器在专用窗口中打开，显示客户端的屏幕并提供交互控件。

传输技术

H.264 编码

客户端屏幕使用 H.264 视频编码，在低带宽下提供高视觉质量。关键帧使用 JPEG 编码作为备用方案，确保快速初始显示和丢包恢复。

UDP 帧传输

编码的帧通过 UDP 传输，实现最低延迟。每个帧被分割为多个块，使用带有 30 字节头部的结构化协议，包含：

这种分块方式允许大帧在网络中可靠传输，同时保持单个 UDP 包在安全 MTU 限制内。

交互控件

鼠标和键盘中继

连接后，服务端操作员的鼠标移动、点击和键盘输入被中继到客户端 PC。客户端执行这些输入就像在本地操作一样，实现完全交互控制。

剪贴板同步

活跃的远程桌面会话期间，服务端和客户端之间的剪贴板自动同步。在服务端复制的文本可以在客户端粘贴，反之亦然。

比特率和画质

传输比特率可在 350 kbps 到 25,000 kbps 之间配置。自动调节机制监控网络状况并动态缩放比特率以保持流畅的观看体验：

• 在快速稳定的网络上，比特率增加以获得更清晰的画质。
• 在拥塞或慢速网络上，比特率降低以防止丢帧和卡顿。

管理员也可以手动选择在不同使用场景（如监控与主动控制）间平衡画质、帧率和比特率的流预设。

可配置设置

远程桌面查看器提供以下设置：

• 画质 -- 编码帧的图像质量级别。
• 帧率 -- 流的目标每秒帧数。
• 比特率 -- 手动比特率覆盖或自动模式。
• 光标可见性 -- 是否显示远程光标覆盖。
• 流预设 -- 常见场景的预定义配置。

会话录制

远程桌面会话可以录制为 MP4 文件以便后续查看。录制使用 FFmpeg 子进程将传入的帧流编码为标准视频文件。录制文件保存在 config_dir/recordings/ 目录中，带有时间戳文件名。

丢包追踪

查看器显示丢包率百分比，指示传输中丢失了多少帧或块。高丢包率表明网络拥塞，可能需要降低比特率或排查网络问题。