Risoluzione problemi abbinamento telefono.
Come funziona l'abbinamento
Il lato studio (il browser desktop) apre una connessione PeerJS e genera un PIN di 6 caratteri. Il PIN viene incorporato in un codice QR come parte dell'URL lato telefono screenshotify.app/app?peer=ID&pin=PIN. Il telefono scansiona il QR, apre l'URL e si riconnette allo studio. Il PIN viene verificato, poi si apre il canale dati. Da quel momento, il pulsante del selettore foto sul telefono (etichettato nella lingua dell'interfaccia attuale dell'app per telefono) invia i dati dell'immagine direttamente allo studio via WebRTC.
Se il QR non si connette
- Entrambi i browser devono supportare WebRTC. Safari 17+, Chrome 100+, Firefox 100+, Edge. Le versioni precedenti di Safari non hanno l'API data-channel abilitata.
- Entrambi devono avere internet. L'abbinamento usa il server di segnalazione di PeerJS per stabilire la connessione diretta; senza una connessione funzionante su uno dei due lati, l'handshake QR fallisce.
- I firewall aziendali/scolastici bloccano spesso WebRTC. Su una rete ospite o VPN aziendale, il traffico STUN/TURN di WebRTC potrebbe essere filtrato. Prova con un hotspot mobile dal telefono.
- Timeout dell'handshake di autenticazione. Una volta che il telefono si connette al canale dati dello studio, ha 3 secondi per inviare il messaggio di autenticazione. Se l'handshake si blocca (problema di rete, scheda del browser in background), lo studio chiude la connessione. Fai clic su "Collega telefono" per avviare una nuova sessione. Il PIN è valido finché il modal rimane aperto.
"Permesso fotocamera negato" su iOS Safari
iOS Safari limita l'accesso alla fotocamera in modo aggressivo. Tre cose da verificare:
- Impostazioni Safari → Fotocamera → Chiedi oppure Consenti per screenshotify.app
- Lo scanner QR che stai usando non ha bisogno del permesso fotocamera — usa lo scanner QR di sistema
- Se usi il selettore File (non la fotocamera), non è necessario alcun permesso fotocamera
"Non connesso" dopo la scansione
Il canale dati è aperto ma il lato studio non ha riconosciuto il telefono. Di solito significa che il controllo del PIN è scaduto prima che il lato telefono potesse inviare il suo messaggio di autenticazione. Chiudi la scheda del telefono, genera un nuovo QR sul lato studio e scansiona di nuovo.
L'abbinamento funziona ma le immagini non appaiono
I dati delle immagini viaggiano in una sola direzione: telefono → studio. Se lo studio non mostra l'immagine dopo che il telefono dice "Inviato", verifica:
- L'editor dello studio è ancora aperto nella stessa scheda del browser in cui hai scansionato il QR
- Non hai navigato verso un'altra pagina sul lato studio (la connessione si interrompe)
- L'immagine è sotto i 5 MB; le catture molto grandi a volte saturano il canale dati
Nota sulla privacy
I dati degli screenshot viaggiano direttamente da telefono a studio via WebRTC. Niente passa attraverso i nostri server. Il server di segnalazione (PeerJS) vede solo che due peer vogliono connettersi — non vede il contenuto delle immagini.