Solução de problemas no pareamento por celular.
Como o pareamento funciona
O lado do desktop (o navegador no computador) abre uma conexão PeerJS e gera um PIN de 6 caracteres. O PIN é incorporado em um QR code como parte da URL do celular screenshotify.app/app?peer=ID&pin=PIN. O celular escaneia o QR, abre a URL e se conecta de volta ao desktop. O PIN é verificado e o canal de dados é aberto. A partir daí, o botão de seleção de fotos do celular (com o rótulo no idioma atual da interface do app no celular) envia os dados da imagem diretamente para o desktop via WebRTC.
Se o QR não conectar
- Os dois navegadores precisam suportar WebRTC. Safari 17+, Chrome 100+, Firefox 100+, Edge. Versões mais antigas do Safari não têm a API de data-channel habilitada.
- Os dois precisam de internet. O pareamento usa o servidor de sinalização do PeerJS para estabelecer a conexão direta; sem uma conexão funcionando em qualquer um dos lados, o handshake do QR falha.
- Firewalls corporativos ou escolares frequentemente bloqueiam o WebRTC. Se você estiver em uma rede de convidados ou VPN corporativa, o tráfego STUN/TURN do WebRTC pode estar sendo filtrado. Tente usar o hotspot móvel do celular.
- Timeout no handshake de autenticação. Assim que o celular se conecta ao canal de dados do desktop, ele tem uma janela de 3 segundos para enviar a mensagem de autenticação. Se esse handshake travar (queda de rede, aba do navegador em segundo plano), o desktop encerra a conexão. Clique em "Conectar celular" novamente para iniciar uma nova sessão. O PIN em si é válido enquanto o modal estiver aberto.
"Permissão de câmera negada" no iOS Safari
O iOS Safari restringe o acesso à câmera de forma agressiva. Três coisas para verificar:
- Ajustes do Safari → Câmera → Perguntar ou Permitir para screenshotify.app
- O leitor de QR que você está usando não precisa da permissão de câmera do Screenshotify — é o leitor de QR do sistema
- Se você usar o seletor de Arquivos (não a câmera), nenhuma permissão de câmera é necessária
"Não conectado" após escanear
O canal de dados está aberto, mas o desktop não reconheceu o celular. Normalmente significa que a verificação do PIN expirou antes que o celular conseguisse enviar a mensagem de autenticação. Feche a aba no celular, gere um novo QR no desktop e escaneie novamente.
O pareamento funciona, mas as imagens não aparecem
Os dados da imagem vão em uma direção: celular → desktop. Se o desktop não mostrar a imagem após o celular indicar "Enviado", verifique:
- O editor no desktop ainda está aberto na mesma aba do navegador onde você escaneou o QR
- Você não navegou para outra página no desktop (a conexão cai)
- A imagem tem menos de 5 MB; capturas muito grandes às vezes travam o canal de dados
Lembrete de privacidade
Os dados das capturas de tela viajam diretamente do celular para o desktop via WebRTC. Nada passa pelos servidores do Screenshotify. O servidor de sinalização (PeerJS) apenas sabe que dois peers querem se conectar — ele não vê o conteúdo das imagens.