Blog

WebRTC-verbinding mislukt: zo vind je waarom een videogesprek niet verbindt

· Andrij Tkachenko · 4 min leestijd

Twee browservensters verbonden door een stippellijn die in het midden breekt, met een vergrootglas boven de kloof

Een WebRTC-verbinding mislukt als de twee apparaten elke weg tussen hen hebben geprobeerd en geen enkele werkt. De oorzaak is bijna altijd een netwerk dat de weg blokkeert, een TURN-server die ontbreekt of kapot is, of kandidaten die de andere kant nooit bereikten, en je ziet in een paar minuten welke het is.

In dit artikel lees je hoe je dat vindt: wat “mislukt” echt betekent, hoe je het netwerk aan beide kanten test, hoe je je TURN-server controleert en waar je in de browser naar kijkt.

Wat “mislukt” betekent

Voordat een gesprek verbindt, verzamelt elke browser zijn kandidaten, de adressen waarop hij bereikbaar zou kunnen zijn. Je signaleringsserver geeft ze door aan de andere kant, en de browsers proberen paren ervan tot er één doorkomt. Dit is ICE, en als elk paar is mislukt, gaat de verbinding naar failed.

Log eerst de statussen aan beide kanten, want ze laten zien hoe ver een gesprek kwam:

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

Firefox zegt het in zijn console duidelijker: “ICE failed, add a TURN server”. Dat is goed advies, al is het niet altijd het hele verhaal.

Stap 1: test het netwerk aan elke kant

Open de WebRTC-test op beide apparaten. Je hebt er geen account of machtiging voor nodig, dus je kunt hem sturen naar de persoon bij wie het gesprek mislukt. Hij controleert de browser, of UDP naar buiten kan, hoe het netwerk adressen toewijst en of een relay en een WebSocket doorkomen. Daarna zegt hij in gewone woorden wat hij vond:

  • WebRTC werkt niet in deze browser. Vaak heeft een extensie, een VPN of een bedrijfsbeleid het uitgezet. Het netwerk doet er niet toe zolang dat niet is opgelost.
  • UDP lijkt geblokkeerd. Directe gesprekken kunnen vanaf hier niet verbinden. Alleen een relay over TCP kan een gesprek dragen, meestal op poort 443.
  • Gesprekken hebben vaak een relay nodig. Het netwerk is een symmetrische NAT, die elke server waarmee hij praat een andere poort geeft. De poort die een ander apparaat leert, werkt dan niet voor hem, dus directe verbindingen mislukken vaak.
  • Gesprekken zouden moeten verbinden. Het netwerk houdt een stabiel adres aan en laat UDP naar buiten. Is deze kant in orde, kijk dan naar de andere.

Twee mensen kunnen elk slagen en toch samen mislukken, want een directe weg vraagt dat beide netwerken hem toestaan. Daar is een relay voor.

Stap 2: controleer je TURN-server

Heeft een van beide kanten een relay nodig en mislukt het gesprek nog steeds, dan is de TURN-server de volgende verdachte. De gebruikelijke problemen:

  • Er is er geen. Met alleen STUN in iceServers heeft een gesprek tussen twee strenge netwerken helemaal geen weg. Het werkt op je kantoor en mislukt voor een deel van je gebruikers.
  • De inloggegevens zijn verlopen. Tijdelijke inloggegevens die bij het laden van de pagina zijn gemaakt, kunnen aflopen voordat een gesprek begint.
  • De relaypoorten zijn dicht. De server deelt een adres uit en er gaat geen data door.
  • Hij biedt maar één ingang. Een netwerk dat UDP blokkeert, heeft TURN over TCP of TLS nodig, het liefst op poort 443.

Een TURN-server testen loopt elk van deze langs, met onze TURN-server test om ze uit te voeren. STUN- en TURN-servers legt uit waar elk voor dient.

Stap 3: kijk naar de kandidaten

Zien het netwerk en de relay er goed uit, kijk dan wat de browsers echt hebben geprobeerd. Open chrome://webrtc-internals in Chrome of Edge, of about:webrtc in Firefox, in een ander tabblad terwijl het gesprek loopt. Beide tonen elke verbinding, zijn kandidaten en welke paren zijn geprobeerd.

Wat je vindt, wijst naar de oorzaak:

  • Alleen host-kandidaten. De browser heeft nooit een STUN-server bereikt, dus hij heeft alleen lokale adressen, waar je vanaf een ander netwerk niets aan hebt. Controleer de iceServers die je meegaf en of de server bereikbaar is.
  • Geen relay-kandidaat. De TURN-server weigerde de login of antwoordde niet. De fouten bij de kandidaten zeggen welke.
  • Hier kandidaten, maar geen van de andere kant. Ze zijn nooit aangekomen, wat wijst op je signalering. Controleer dat elke kant ze verstuurt en toevoegt.
  • Kandidaten aan beide kanten en elk paar mislukt. De netwerken blokkeren de weg, en zonder relay is daar aan jouw kant niets aan te doen.

Een veelvoorkomende oorzaak van ontbrekende kandidaten is timing: een kandidaat toevoegen voordat de remote description is ingesteld geeft een fout, en code die de fout inslikt, verliest de kandidaat. Zet ze in de wachtrij tot setRemoteDescription() klaar is.

Als hij verbindt en dan wegvalt

disconnected is niet failed. Het betekent dat pakketjes even stopten, zoals gebeurt als iemand uit het bereik van wifi loopt, en vaak herstelt het vanzelf. Is het eenmaal failed, dan kan een gesprek herstellen zonder op te hangen door het opnieuw te proberen:

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

restartIce() laat het volgende aanbod opnieuw verzamelen en proberen, dus je signalering moet dat nieuwe aanbod naar de andere kant brengen.

Hoe WordPlus Cloud dit aanpakt

Op WordPlus Cloud gaat een gesprek rechtstreeks tussen twee apparaten als dat kan, via de relay die het dichtst bij elke persoon is als een firewall dat blokkeert, en via onze mediaservers als zelfs de relays niet kunnen bereiken, zonder op te hangen. Er is dus altijd een volgende weg om op terug te vallen, en je hoeft er niets van te draaien. Hoe we je gebruikers verbinden laat zien waar die servers staan, en gebruikers over regio’s verbinden legt uit hoe gesprekken ze overspannen.

Mislukt een gesprek op ons netwerk, dan laat de verbindingstest zien of dat netwerk onze servers bereikt. De docs over gesprekken en videogesprekken voor apps laten zien hoe je erop bouwt.