Khắc phục sự cố ghép đôi điện thoại.
Cách ghép đôi hoạt động
Phía studio (trình duyệt máy tính) mở kết nối PeerJS và tạo PIN 6 ký tự. PIN được nhúng vào mã QR như một phần của URL phía điện thoại screenshotify.app/app?peer=ID&pin=PIN. Điện thoại quét mã QR, mở URL, kết nối lại với studio. PIN được xác minh, rồi kênh dữ liệu mở. Từ đó, nút chọn ảnh trên điện thoại (được gắn nhãn theo ngôn ngữ UI hiện tại của ứng dụng điện thoại) gửi dữ liệu hình ảnh trực tiếp đến studio qua WebRTC.
Nếu mã QR không kết nối được
- Cả hai trình duyệt đều phải hỗ trợ WebRTC. Safari 17+, Chrome 100+, Firefox 100+, Edge. Các phiên bản Safari cũ hơn không bật API data-channel.
- Cả hai cần có internet. Quá trình ghép đôi dùng máy chủ tín hiệu của PeerJS để thiết lập kết nối trực tiếp; nếu một trong hai bên không có kết nối, bắt tay QR sẽ thất bại.
- Tường lửa công ty / trường học thường chặn WebRTC. Nếu bạn đang dùng mạng khách hoặc VPN công ty, lưu lượng STUN/TURN của WebRTC có thể bị lọc. Hãy thử điểm phát sóng di động từ điện thoại.
- Timeout bắt tay xác thực. Khi điện thoại kết nối với kênh dữ liệu của studio, nó có 3 giây để gửi tin nhắn xác thực. Nếu bắt tay bị treo (mạng bị lỗi, tab trình duyệt bị nền hóa), studio sẽ ngắt kết nối. Nhấp "Kết nối điện thoại" để bắt đầu phiên mới. PIN vẫn hợp lệ miễn là modal còn mở.
"Đã từ chối quyền camera" trên iOS Safari
iOS Safari hạn chế quyền truy cập camera rất chặt. Ba điều cần kiểm tra:
- Cài đặt Safari → Camera → Hỏi hoặc Cho phép cho screenshotify.app
- Trình quét mã QR bạn đang dùng không cần quyền camera của Screenshotify — đó là trình quét QR hệ thống
- Nếu bạn dùng bộ chọn Files (không phải camera), không cần quyền camera
"Không kết nối được" sau khi quét
Kênh dữ liệu đã mở nhưng phía studio không xác nhận điện thoại. Thường có nghĩa là kiểm tra PIN đã hết thời gian trước khi phía điện thoại có thể gửi tin nhắn xác thực. Đóng tab điện thoại, tạo mã QR mới trên phía studio, quét lại.
Ghép đôi thành công nhưng ảnh không xuất hiện
Dữ liệu ảnh đi theo một chiều: điện thoại → studio. Nếu studio không hiển thị ảnh sau khi điện thoại báo "Đã gửi", hãy kiểm tra:
- Trình chỉnh sửa studio vẫn đang mở trong cùng tab trình duyệt nơi bạn quét mã QR
- Bạn chưa điều hướng đến trang khác trên phía studio (kết nối sẽ bị ngắt)
- Ảnh dưới 5 MB; các ảnh chụp rất lớn đôi khi làm nghẹt kênh dữ liệu
Lưu ý về quyền riêng tư
Dữ liệu ảnh chụp màn hình đi trực tiếp từ điện thoại sang studio qua WebRTC. Không có gì đi qua máy chủ của Screenshotify. Máy chủ tín hiệu (PeerJS) chỉ biết rằng hai người dùng muốn kết nối — nó không thấy dữ liệu ảnh.