Hilfe · Smartphone-Kopplung

Fehlerbehebung Smartphone-Kopplung.

Kurzfassung. Sowohl das Smartphone als auch der Editor brauchen WebRTC-Unterstützung und eine funktionierende Internetverbindung. Die häufigsten Ursachen: Eine Unternehmens-Firewall blockiert WebRTC, oder der WebRTC-Handshake ist hängengeblieben. Lade beide Seiten neu und versuche es erneut.

Wie die Kopplung funktioniert

Der Editor (der Desktop-Browser) öffnet eine PeerJS-Verbindung und generiert eine 6-stellige PIN. Die PIN wird als Teil der Smartphone-URL screenshotify.app/app?peer=ID&pin=PIN in einen QR-Code eingebettet. Das Smartphone scannt den QR-Code, öffnet die URL und stellt die Verbindung zum Editor her. Die PIN wird geprüft, danach öffnet sich der Datenkanal. Ab diesem Punkt sendet die Schaltfläche zum Auswählen von Fotos in der Smartphone-App (mit der Beschriftung der aktuellen UI-Sprache der App) die Bilddaten direkt über WebRTC an den Editor.

Wenn der QR-Code keine Verbindung herstellt

Beide Browser müssen WebRTC unterstützen. Safari 17+, Chrome 100+, Firefox 100+, Edge. Ältere Safari-Versionen haben die Datenkanal-API nicht aktiviert.
Beide Seiten brauchen Internet. Die Kopplung nutzt den Signaling-Server von PeerJS, um die direkte Verbindung aufzubauen. Ohne funktionierende Verbindung auf einer der beiden Seiten schlägt der QR-Handshake fehl.
Unternehmens- und Schul-Firewalls blockieren WebRTC häufig. Wenn du in einem Gastnetzwerk oder Unternehmens-VPN bist, wird WebRTC-STUN/TURN-Datenverkehr möglicherweise gefiltert. Versuche es mit einem mobilen Hotspot vom Smartphone.
Authentifizierungs-Timeout. Sobald sich das Smartphone mit dem Datenkanal des Editors verbindet, hat es ein 3-Sekunden-Fenster, um seine Authentifizierungsnachricht zu senden. Bleibt der Handshake hängen (Netzwerkunterbrechung, Browser-Tab im Hintergrund), trennt der Editor die Verbindung. Klicke erneut auf „Connect phone”, um eine neue Sitzung zu starten. Die PIN selbst ist gültig, solange das Dialogfenster offen bleibt.

„Camera permission denied“ in iOS Safari

iOS Safari schränkt den Kamerazugriff sehr streng ein. Drei Dinge zum Überprüfen:

Safari Settings → Camera → Ask oder Allow für screenshotify.app
Der QR-Scanner braucht keine Kameraberechtigung für screenshotify.app — er nutzt den System-QR-Scanner
Wenn du den Dateiauswähler nutzt (nicht die Kamera), ist überhaupt keine Kameraberechtigung nötig

„Nicht verbunden” nach dem Scannen

Der Datenkanal ist offen, aber der Editor hat das Smartphone nicht bestätigt. Meist bedeutet das, dass die PIN-Prüfung abgelaufen ist, bevor das Smartphone seine Authentifizierungsnachricht senden konnte. Schließe den Smartphone-Tab, erstelle einen neuen QR-Code im Editor und scanne erneut.

Kopplung funktioniert, aber Bilder erscheinen nicht

Bilddaten fließen in eine Richtung: Smartphone → Editor. Wenn der Editor das Bild nicht anzeigt, nachdem das Smartphone „Gesendet” anzeigt, prüfe Folgendes:

Der Editor ist noch im selben Browser-Tab geöffnet, in dem du den QR-Code gescannt hast
Du hast auf der Editor-Seite nicht zu einer anderen Seite navigiert (die Verbindung wird dabei getrennt)
Das Bild ist kleiner als 5 MB — sehr große Aufnahmen überlasten den Datenkanal manchmal

Datenschutzhinweis

Screenshot-Daten werden direkt vom Smartphone zum Editor über WebRTC übertragen. Wir leiten nichts über unsere Server. Der Signaling-Server (PeerJS) sieht nur, dass zwei Peers eine Verbindung herstellen möchten — den Bildinhalt sieht er nicht.

Editor öffnen → Funktionsweise