连接失败与网络问题
扫了码没反应 / 一直转圈
排查清单
| 检查项 | 说明 |
|---|---|
| 同一 Wi-Fi？ | 发射端和接收端必须在同一网络 |
| 二维码过期了？ | 接收端的二维码有时效，让接收端刷新一下 |
| 摄像头权限？ | KShare 需要摄像头权限才能扫码，检查系统设置 |
| IP 地址冲突？ | 偶尔网络 DHCP 分配冲突，两端都重启 Wi-Fi |
| 防火墙拦截？ | 企业网络可能阻止 KShare 使用的端口（见下方） |
企业 Wi-Fi 防火墙
KShare 默认使用以下端口进行通信。如果你的企业 Wi-Fi 启用了严格防火墙，请让 IT 管理员放行：
| 协议 | 端口 | 用途 |
|---|---|---|
| UDP | 5353 | mDNS 设备发现 |
| TCP | 随机高位端口（通常 50000+） | 投屏数据传输 |
| UDP | 随机高位端口 | 抖动缓冲控制 |
| ICMP | - | 网络可达性检测 |
投屏码报"无效"
最常见原因：接收端的投屏码已经刷新。
接收端在以下情况会自动刷新投屏码：
- 上一个投屏会话结束后
- 接收端重启后
- 管理员手动刷新
解决：到接收端屏幕上重新看一眼最新的投屏码，确认没有打错。
自动发现看不到接收端
可能原因
Wi-Fi 隔离 / AP 隔离
- 很多企业路由器开启了"客户端隔离"或"AP 隔离"
- 结果：同一个 Wi-Fi 下的设备之间互相看不到
- 解决：让 IT 关闭 AP 隔离，或改用扫码 / 投屏码连接
多 VLAN
- 企业网络按部门划分为多个 VLAN
- 手机在 VLAN-A，大屏在 VLAN-B，互相不可达
- 解决：扫码 / 投屏码手动连接，或让 IT 打通两个 VLAN
设备休眠
- 接收端皓丽大屏进入深度休眠后 KShare 服务停止
- 解决：触摸大屏唤醒，等待 KShare 服务重新启动（通常 10~20 秒）
连接后立即断开
排查顺序
- 接收端设置了设备白名单：你的设备不在白名单里，连上过不去
- 投屏会话满：接收端同时连接的设备数已达上限（默认 9 台），新连接排队等待
- 跨网络模式没开：发射端和接收端不在同一 Wi-Fi，但跨网络模式未启用
- 加密不匹配：老版本客户端连新版本接收端，加密协商失败
- KShare 服务崩了：接收端 KShare 服务异常，重启接收端
查看接收端状态
皓丽大屏上可以在 KShare 设置 → 诊断信息中查看：
- 当前连接设备数
- 每个设备的连接时间和断开原因
- KShare 服务运行状态（正常 / 异常）
- 网络连接状态
连接很慢（需要好几秒）
正常情况下扫码连接应该在 3 秒内完成。如果需要 5 秒以上：
- 检查接收端 Wi-Fi 信号
- 清理接收端已连接的历史设备记录
- 两边都重启 KShare App / 服务
- 升级到最新版本