断线自动重连与网络切换

为什么会掉线

投屏过程中最常见的掉线原因：

• Wi-Fi 信号波动（隔了墙、路由器重启、信道干扰）
• Wi-Fi 漫游（手机/笔记本从一个 AP 走到另一个 AP 覆盖区）
• 接收端休眠（大屏超时进入深度休眠）
• 路由器带宽打满（同时投屏的设备太多）

KShare 自动重连机制

瞬时网络波动（< 3 秒）

KShare 协议内置抖动缓冲——短时丢包不会导致画面冻结，缓冲队列维持在 300~500ms 左右。这种波动用户基本感知不到。

中等网络中断（3~15 秒）

客户端会自动进入重连状态：

• 屏幕上显示"正在重连..."提示
• 持续尝试连接原接收端
• 重连成功后画面从断点继续，不会从头开始

长时间断网（> 15 秒）

超过 15 秒后，客户端会判定为主动断开，弹出连接失败提示。此时需要用户手动点击重连按钮或重新扫码。

接收端重启后的重连

如果皓丽大屏重启了（管理员手动、系统更新、异常崩溃），接收端的 KShare 服务会在开机后自动启动。客户端在短时间内（通常 30 秒内）检测到接收端恢复后会自动重连，无需用户操作。

跨 Wi-Fi 重连

如果你的设备从一个 Wi-Fi 切换到另一个（比如从办公区到会议室），原接收端在新 Wi-Fi 上是不可达的。此时：

• KShare 会检测到旧接收端不可达
• 自动扫描新 Wi-Fi 上的同型号接收端
• 如果发现匹配设备，提示用户是否切换

注意：跨 Wi-Fi 切换时，投屏会中断，需要重新建立会话（相当于手动换接收端）。KShare 不会强行跨 Wi-Fi 保持同一个投屏会话。

手动重连技巧

客户端托盘图标（桌面端）或主界面（手机端）上有一个重连按钮。在以下情况主动点击重连可能比等待自动重连更快：

• 画面冻结但还在显示最后一帧
• 声音有延迟但画面不动
• 接收端刚刚重启完成

防止掉线的建议