Pomoc · Parowanie telefonu

Rozwiązywanie problemów z parowaniem telefonu.

W skrócie. Zarówno telefon, jak i studio muszą obsługiwać WebRTC i mieć działające połączenie z internetem. Najczęstsze przyczyny problemów: firmowy firewall blokuje WebRTC albo nawiązywanie połączenia WebRTC samo w sobie się zawiesiło. Odśwież obie strony i spróbuj ponownie.

Jak działa parowanie

Strona studia (przeglądarka na komputerze) otwiera połączenie PeerJS i generuje 6-znakowy PIN. PIN jest osadzany w kodzie QR jako część URL-a po stronie telefonu: screenshotify.app/app?peer=ID&pin=PIN. Telefon skanuje kod QR, otwiera URL i łączy się ze studiem. PIN jest weryfikowany, po czym otwierany jest kanał danych. Od tej chwili przycisk wyboru zdjęć na telefonie (oznaczony w aktualnym języku UI aplikacji na telefon) przesyła dane obrazu bezpośrednio do studia przez WebRTC.

Jeśli kod QR nie łączy

Obie przeglądarki muszą obsługiwać WebRTC. Safari 17+, Chrome 100+, Firefox 100+, Edge. Starsze wersje Safari nie mają włączonego API kanału danych.
Obie strony potrzebują internetu. Parowanie używa serwera sygnalizacyjnego PeerJS do nawiązania bezpośredniego połączenia; bez działającego połączenia po którejkolwiek stronie handshake QR nie uda się.
Firmowe i szkolne firewalle często blokują WebRTC. Jeśli korzystasz z sieci gościnnej lub firmowej sieci VPN, ruch STUN/TURN WebRTC może być filtrowany. Spróbuj przez mobilny hotspot z telefonu.
Timeout handshake autoryzacji. Po połączeniu telefonu z kanałem danych studia ma on 3 sekundy na wysłanie wiadomości autoryzacyjnej. Jeśli ten handshake się zawiesi (chwilowy problem z siecią, karta przeglądarki w tle), studio zrywa połączenie. Kliknij „Podłącz telefon” ponownie, żeby rozpocząć nową sesję. Sam PIN jest ważny tak długo, jak modal pozostaje otwarty.

„Camera permission denied” w iOS Safari

iOS Safari agresywnie ogranicza dostęp do kamery. Trzy rzeczy do sprawdzenia:

Ustawienia Safari → Kamera → Pytaj lub Zezwalaj dla screenshotify.app
Używany skaner QR nie potrzebuje uprawnienia do kamery od Screenshotify — korzysta z systemowego skanera QR
Jeśli używasz selektora Pliki (nie kamery), uprawnienie do kamery nie jest w ogóle potrzebne

„Not connected” po zeskanowaniu kodu

Kanał danych jest otwarty, ale strona studia nie potwierdziła połączenia z telefonem. Zazwyczaj oznacza to, że sprawdzenie PIN-u przekroczyło limit czasu, zanim strona telefonu zdążyła wysłać wiadomość autoryzacyjną. Zamknij kartę na telefonie, wygeneruj nowy kod QR po stronie studia i zeskanuj ponownie.

Parowanie działa, ale obrazy się nie pojawiają

Dane obrazu płyną w jednym kierunku: telefon → studio. Jeśli studio nie wyświetla obrazu po tym, jak telefon potwierdził wysłanie, sprawdź:

Edytor studia jest nadal otwarty w tej samej karcie przeglądarki, w której zeskanowałeś kod QR
Nie przeszedłeś na inną stronę po stronie studia (połączenie zostaje wtedy zerwane)
Obraz ma rozmiar poniżej 5 MB; bardzo duże ujęcia czasami przeciążają kanał danych

Przypomnienie o prywatności

Dane zrzutu ekranu podróżują bezpośrednio z telefonu do studia przez WebRTC. Nic nie przechodzi przez serwery Screenshotify. Serwer sygnalizacyjny (PeerJS) widzi tylko to, że dwa urządzenia chcą się połączyć — nie widzi zawartości przesyłanego obrazu.

Otwórz edytor → Jak to działa