폰 연결 문제 해결.

연결 방식

스튜디오(데스크탑 브라우저)가 PeerJS 연결을 열고 6자리 PIN을 생성해요. PIN은 폰 측 URL screenshotify.app/app?peer=ID&pin=PIN의 일부로 QR 코드에 포함돼요. 폰이 QR을 스캔하고 URL을 열어 스튜디오에 다시 연결해요. PIN이 확인되면 데이터 채널이 열려요. 이후 폰의 사진 선택 버튼(폰 앱의 현재 UI 언어로 표시됨)을 통해 이미지 데이터가 WebRTC를 통해 스튜디오로 직접 전송돼요.

QR이 연결되지 않는 경우

1. 두 브라우저 모두 WebRTC를 지원해야 해요. Safari 17+, Chrome 100+, Firefox 100+, Edge. 구형 Safari 버전은 데이터 채널 API가 활성화되지 않았어요.
2. 두 기기 모두 인터넷이 필요해요. 연결 설정을 위해 PeerJS의 시그널링 서버를 사용해요. 어느 한 쪽에 연결 문제가 있으면 QR 핸드셰이크가 실패해요.
3. 회사/학교 방화벽이 WebRTC를 차단하는 경우가 많아요. 게스트 네트워크나 회사 VPN을 사용 중이라면 WebRTC의 STUN/TURN 트래픽이 필터링될 수 있어요. 폰의 모바일 핫스팟을 시도해보세요.
4. 인증 핸드셰이크 타임아웃. 폰이 스튜디오의 데이터 채널에 연결되면 인증 메시지를 보낼 3초의 시간이 있어요. 핸드셰이크가 멈추면(네트워크 순단, 브라우저 탭 백그라운드 전환), 스튜디오가 연결을 끊어요. "폰 연결"을 다시 클릭해 새 세션을 시작하세요. PIN 자체는 모달이 열려 있는 한 유효해요.

iOS Safari에서 "카메라 권한 거부"

iOS Safari는 카메라 접근을 엄격하게 제한해요. 세 가지를 확인하세요:

• Safari 설정 → 카메라 → 묻기 또는 screenshotify.app에 대해 허용
• 사용 중인 QR 스캐너는 카메라 권한이 필요 없어요 — 시스템 QR 스캐너를 사용해요
• 파일 선택기(카메라 아님)를 사용하면 카메라 권한이 전혀 필요 없어요

스캔 후 "연결 안 됨"

데이터 채널은 열렸지만 스튜디오가 폰을 확인하지 못한 상태예요. 보통 폰 측이 인증 메시지를 보내기 전에 PIN 확인이 타임아웃된 경우예요. 폰 탭을 닫고, 스튜디오에서 새 QR을 생성하고 다시 스캔하세요.

연결은 됐는데 이미지가 나타나지 않는 경우

이미지 데이터는 폰 → 스튜디오 방향으로만 전송돼요. 폰에서 "전송됨"으로 표시되는데 스튜디오에 이미지가 나타나지 않는다면 확인하세요:

• 스튜디오 에디터가 QR을 스캔한 동일한 브라우저 탭에서 열려 있는지
• 스튜디오 측에서 다른 페이지로 이동하지 않았는지(이동하면 연결이 끊겨요)
• 이미지가 5 MB 미만인지. 매우 큰 캡처는 데이터 채널에서 처리가 막힐 수 있어요

개인정보 안내

스크린샷 데이터는 WebRTC를 통해 폰에서 스튜디오로 직접 전송돼요. 서버를 경유하지 않아요. 시그널링 서버(PeerJS)는 두 피어가 연결을 원한다는 것만 볼 수 있어요 — 이미지 내용은 보지 못해요.

에디터 열기 → 작동 방식 보기