帮助·手机配对
手机配对故障排查。
简而言之。 手机和桌面端都需要支持 WebRTC 并保持正常的数据连接。最常见的失败原因：企业防火墙屏蔽了 WebRTC，或 WebRTC 握手本身卡住。两端刷新后重试。
配对原理
桌面端（桌面浏览器）发起 PeerJS 连接并生成 6 位字符 PIN。PIN 作为手机端 URL screenshotify.app/app?peer=ID&pin=PIN 的一部分嵌入 QR 码。手机扫描 QR 码，打开 URL，连接回桌面端。PIN 验证通过后，数据通道开启。此后，手机上的照片选择按钮（以手机端应用当前界面语言显示）通过 WebRTC 直接向桌面端发送图像数据。
QR 码无法连接
- 两端浏览器均须支持 WebRTC。Safari 17+、Chrome 100+、Firefox 100+、Edge。旧版 Safari 未启用数据通道 API。
- 两端均需联网。配对使用 PeerJS 信令服务器建立直连；任意一端断网，QR 握手即会失败。
- 企业/学校防火墙通常会屏蔽 WebRTC。如果你在访客网络或企业 VPN 下，WebRTC 的 STUN/TURN 流量可能被过滤。请尝试用手机开启移动热点。
- 认证握手超时。手机连接到桌面端数据通道后，有 3 秒窗口发送认证消息。若握手卡住（网络抖动、浏览器标签页切入后台），桌面端会断开连接。再次点击「Connect phone」发起新会话。只要弹窗保持打开，PIN 本身持续有效。
iOS Safari 上「相机权限被拒」
iOS Safari 对相机访问有严格限制。请检查以下三点：
- Safari 设置 → 相机 → 询问或允许 screenshotify.app
- 你使用的 QR 扫描器不需要相机权限——它使用系统 QR 扫描器
- 如果使用文件选择器（而非相机），则完全不需要相机权限
扫描后显示「未连接」
数据通道已开启，但桌面端未确认手机连接。通常是因为 PIN 校验在手机端发送认证消息前超时。关闭手机端标签页，在桌面端重新生成 QR 码后再次扫描。
配对成功但图像未显示
图像数据单向传输：手机 → 桌面。如果手机显示「已发送」后桌面端编辑器未出现图像，请检查：
- 桌面端编辑器仍在扫描 QR 码时所在的同一浏览器标签页中打开
- 桌面端未跳转到其他页面（跳转会断开连接）
- 图像文件小于 5 MB；过大的截图有时会导致数据通道卡顿
隐私提示
截图数据通过 WebRTC 直接从手机传输到桌面端，不经过 Screenshotify 的服务器。信令服务器（PeerJS）只知道两个对等端希望建立连接，看不到图像数据内容。