Blog

WebRTC-Verbindung fehlgeschlagen: Warum ein Videoanruf sich nicht verbindet

· Andrij Tkachenko · 4 Min. Lesezeit

Zwei Browserfenster, verbunden durch eine gepunktete Linie, die in der Mitte abbricht, mit einer Lupe über der Lücke

Eine WebRTC-Verbindung scheitert, wenn die beiden Geräte jeden Weg zwischen ihnen versucht haben, den sie kennen, und keiner funktioniert. Die Ursache ist fast immer ein Netzwerk, das den Weg blockiert, ein TURN-Server, der fehlt oder defekt ist, oder Kandidaten, die die andere Seite nie erreicht haben. Welche es ist, lässt sich in wenigen Minuten feststellen.

Dieser Beitrag zeigt, wie Sie sie finden: was „fehlgeschlagen“ wirklich heißt, wie Sie das Netzwerk auf jeder Seite testen, wie Sie Ihren TURN-Server prüfen und worauf Sie im Browser achten.

Was „fehlgeschlagen“ heißt

Bevor ein Anruf sich verbindet, sammelt jeder Browser seine Kandidaten, die Adressen, unter denen er erreichbar sein könnte. Ihr Signaling-Server reicht sie an die andere Seite weiter, und die Browser probieren Paare davon aus, bis eines durchkommt. Das ist ICE, und wenn jedes Paar gescheitert ist, geht die Verbindung auf failed.

Protokollieren Sie zuerst die Zustände auf beiden Seiten, denn sie zeigen, wie weit ein Anruf kam:

JavaScript
pc.onconnectionstatechange = () => console.log('connection', pc.connectionState);
pc.oniceconnectionstatechange = () => console.log('ice', pc.iceConnectionState);
pc.onicegatheringstatechange = () => console.log('gathering', pc.iceGatheringState);

Firefox sagt es in seiner Konsole deutlicher: „ICE failed, add a TURN server“. Das ist ein guter Rat, aber nicht immer die ganze Geschichte.

Schritt 1: Das Netzwerk auf jeder Seite testen

Öffnen Sie den WebRTC-Test auf beiden Geräten. Er braucht kein Konto und keine Berechtigung, Sie können ihn also der Person schicken, deren Anruf scheitert. Er prüft den Browser, ob UDP hinausgelangt, wie das Netzwerk Adressen zuordnet und ob ein Relay und ein WebSocket durchkommen. Dann sagt er in einfachen Worten, was er gefunden hat:

  • WebRTC funktioniert in diesem Browser nicht. Oft hat eine Erweiterung, ein VPN oder eine Firmenrichtlinie es abgeschaltet. Das Netzwerk spielt keine Rolle, bevor das behoben ist.
  • UDP scheint blockiert. Direkte Anrufe können sich von hier aus nicht verbinden. Nur ein Relay über TCP kann einen Anruf tragen, meist auf Port 443.
  • Anrufe brauchen oft ein Relay. Das Netzwerk ist ein symmetrisches NAT, das jedem Server, mit dem es spricht, einen anderen Port gibt. Der Port, den ein anderes Gerät erfährt, funktioniert dann nicht für es, sodass direkte Verbindungen oft scheitern.
  • Anrufe sollten sich verbinden. Das Netzwerk behält eine feste Adresse und lässt UDP hinaus. Ist diese Seite in Ordnung, sehen Sie sich die andere an.

Zwei Personen können beide bestehen und gemeinsam trotzdem scheitern, denn ein direkter Weg braucht die Erlaubnis beider Netzwerke. Dafür gibt es ein Relay.

Schritt 2: Ihren TURN-Server prüfen

Braucht eine der Seiten ein Relay und der Anruf scheitert trotzdem, ist der TURN-Server der nächste Verdächtige. Die üblichen Probleme:

  • Es gibt keinen. Mit nur STUN in iceServers hat ein Anruf zwischen zwei strengen Netzwerken überhaupt keinen Weg. In Ihrem Büro funktioniert er, bei manchen Ihrer Nutzer scheitert er.
  • Seine Zugangsdaten sind abgelaufen. Zeitlich begrenzte Zugangsdaten, die beim Laden der Seite erzeugt wurden, können ablaufen, bevor ein Anruf beginnt.
  • Seine Relay-Ports sind geschlossen. Der Server vergibt eine Adresse, und es laufen keine Daten durch.
  • Er bietet nur einen Zugang an. Ein Netzwerk, das UDP blockiert, braucht TURN über TCP oder TLS, am besten auf Port 443.

TURN-Server testen geht jeden dieser Punkte durch, mit unserem TURN-Server-Test zum Ausführen. STUN- und TURN-Server erklärt, wofür jeder von beiden da ist.

Schritt 3: Die Kandidaten ansehen

Sehen Netzwerk und Relay gut aus, schauen Sie nach, was die Browser tatsächlich versucht haben. Öffnen Sie in Chrome oder Edge chrome://webrtc-internals oder in Firefox about:webrtc in einem anderen Tab, während der Anruf läuft. Beide listen jede Verbindung, ihre Kandidaten und die versuchten Paare auf.

Was Sie dort finden, weist auf die Ursache:

  • Nur host-Kandidaten. Der Browser hat nie einen STUN-Server erreicht und hat nur lokale Adressen, die aus einem anderen Netzwerk nichts nützen. Prüfen Sie die iceServers, die Sie übergeben haben, und ob der Server erreichbar ist.
  • Kein relay-Kandidat. Der TURN-Server hat den Login abgelehnt oder nicht geantwortet. Die Kandidatenfehler sagen, was davon.
  • Hier Kandidaten, von der anderen Seite keine. Sie sind nie angekommen, was auf Ihr Signaling deutet. Prüfen Sie, dass jede Seite sie sendet und hinzufügt.
  • Kandidaten auf beiden Seiten, und jedes Paar ist gescheitert. Die Netzwerke blockieren den Weg, und ohne Relay gibt es dafür auf Ihrer Seite keine Lösung.

Eine häufige Ursache fehlender Kandidaten ist das Timing: Fügen Sie einen hinzu, bevor die Remote-Beschreibung gesetzt ist, wirft das einen Fehler, und Code, der den Fehler verschluckt, verliert den Kandidaten. Stellen Sie sie in eine Warteschlange, bis setRemoteDescription() fertig ist.

Wenn sie sich verbindet und dann abbricht

disconnected ist nicht failed. Es heißt, dass Pakete kurz ausblieben, etwa wenn jemand aus der WLAN-Reichweite geht, und oft erholt es sich von selbst. Hat es failed erreicht, kann ein Anruf sich erholen, ohne aufzulegen, indem er es erneut versucht:

JavaScript
pc.onconnectionstatechange = () => {
  if (pc.connectionState === 'failed') {
    pc.restartIce();
  }
};

restartIce() lässt das nächste Angebot erneut sammeln und probieren. Ihr Signaling muss dieses neue Angebot also zur anderen Seite tragen.

Wie WordPlus Cloud damit umgeht

Auf WordPlus Cloud läuft ein Anruf direkt zwischen zwei Geräten, wenn es geht, über das Relay in der Nähe jeder Person, wenn eine Firewall das blockiert, und über unsere Medienserver, wenn selbst die Relays nicht ankommen, ohne aufzulegen. Es gibt also immer einen nächsten Weg, auf den er zurückfallen kann, und Sie müssen nichts davon betreiben. Wie wir Ihre Nutzer verbinden zeigt, wo diese Server stehen, und Nutzer über Regionen hinweg verbinden erklärt, wie Anrufe sie überspannen.

Scheitert ein Anruf in unserem Netzwerk, zeigt der Verbindungstest, ob dieses Netzwerk unsere Server erreicht. Die Docs zu Anrufen und Videoanrufe für Apps zeigen, wie Sie darauf aufbauen.