Échec de connexion WebRTC : trouver pourquoi un appel vidéo ne se connecte pas

Une connexion WebRTC échoue quand les deux appareils ont essayé tous les chemins qu’ils connaissent entre eux et qu’aucun ne marche. La cause est presque toujours un réseau qui bloque le chemin, un serveur TURN absent ou défaillant, ou des candidates qui ne sont jamais arrivées de l’autre côté, et vous pouvez savoir laquelle en quelques minutes.
Cet article explique comment la trouver : ce que « échec » veut vraiment dire, comment tester le réseau de chaque côté, comment vérifier votre serveur TURN, et ce qu’il faut regarder dans le navigateur.
Ce que « échec » veut dire
Avant qu’un appel se connecte, chaque navigateur rassemble ses candidates, les adresses où on peut le joindre. Votre serveur de signalisation les transmet à l’autre côté, et les navigateurs essaient des paires d’entre elles jusqu’à ce qu’une passe. C’est ICE, et quand toutes les paires ont échoué, la connexion passe à failed.
Consignez d’abord les états des deux côtés, car ils montrent jusqu’où un appel est allé :
pc.onconnectionstatechange = () => console.log('connection', pc.connectionState);
pc.oniceconnectionstatechange = () => console.log('ice', pc.iceConnectionState);
pc.onicegatheringstatechange = () => console.log('gathering', pc.iceGatheringState);Firefox le dit plus clairement dans sa console : « ICE failed, add a TURN server ». C’est un bon conseil, mais ce n’est pas toujours toute l’histoire.
Étape 1 : tester le réseau de chaque côté
Ouvrez le test WebRTC sur les deux appareils. Il ne demande ni compte ni autorisation, vous pouvez donc l’envoyer à la personne dont l’appel échoue. Il vérifie le navigateur, si l’UDP sort, comment le réseau associe les adresses, et si un relais et un WebSocket passent. Puis il dit en termes simples ce qu’il a trouvé :
- WebRTC ne fonctionne pas dans ce navigateur. Une extension, un VPN ou une politique d’entreprise l’a souvent désactivé. Rien du réseau n’importe tant que ce n’est pas réglé.
- L’UDP semble bloqué. Les appels directs ne peuvent pas se connecter d’ici. Seul un relais en TCP peut porter un appel, en général sur le port 443.
- Les appels auront souvent besoin d’un relais. Le réseau est un NAT symétrique, qui donne un port différent à chaque serveur avec lequel il parle. Le port qu’un autre appareil apprend ne marche alors pas pour lui, et les connexions directes échouent souvent.
- Les appels devraient se connecter. Le réseau garde une adresse stable et laisse sortir l’UDP. Si ce côté va bien, regardez l’autre.
Deux personnes peuvent réussir chacune de leur côté et échouer ensemble, car un chemin direct demande que les deux réseaux l’autorisent. C’est à cela que sert un relais.
Étape 2 : vérifier votre serveur TURN
Si l’un des côtés a besoin d’un relais et que l’appel échoue quand même, le serveur TURN est le suspect suivant. Les problèmes habituels :
- Il n’y en a pas. Avec STUN seul dans
iceServers, un appel entre deux réseaux stricts n’a aucun chemin. Il marche dans vos bureaux et échoue pour certains de vos utilisateurs. - Ses identifiants ont expiré. Des identifiants à durée limitée créés au chargement de la page peuvent s’éteindre avant le début d’un appel.
- Ses ports de relais sont fermés. Le serveur distribue une adresse, et aucune donnée ne passe.
- Il n’offre qu’un seul point d’entrée. Un réseau qui bloque l’UDP a besoin de TURN en TCP ou en TLS, idéalement sur le port 443.
Comment tester un serveur TURN passe chacun de ces points en revue, avec notre test de serveur TURN pour les lancer. Les serveurs STUN et TURN expliquent à quoi sert chacun.
Étape 3 : regarder les candidates
Si le réseau et le relais semblent corrects, regardez ce que les navigateurs ont réellement essayé. Ouvrez chrome://webrtc-internals dans Chrome ou Edge, ou about:webrtc dans Firefox, dans un autre onglet pendant l’appel. Les deux listent chaque connexion, ses candidates et les paires essayées.
Ce que vous y trouvez indique la cause :
- Seulement des candidates
host. Le navigateur n’a jamais joint un serveur STUN, il n’a donc que des adresses locales, inutiles depuis un autre réseau. Vérifiez lesiceServersque vous avez passés et que le serveur est joignable. - Aucune candidate
relay. Le serveur TURN a refusé la connexion ou n’a pas répondu. Les erreurs de candidates disent laquelle. - Des candidates de ce côté mais aucune de l’autre. Elles ne sont jamais arrivées, ce qui pointe vers votre signalisation. Vérifiez que chaque côté les envoie et les ajoute.
- Des candidates des deux côtés, et toutes les paires ont échoué. Les réseaux bloquent le chemin, et sans relais il n’y a rien à corriger de votre côté.
Une cause fréquente de candidates manquantes est le moment : en ajouter une avant que la description distante soit définie lève une erreur, et un code qui avale l’erreur perd la candidate. Mettez-les en file d’attente jusqu’à la fin de setRemoteDescription().
S’il se connecte puis coupe
disconnected n’est pas failed. Cela veut dire que les paquets se sont arrêtés un instant, comme quand quelqu’un sort de la portée du Wi-Fi, et cela se rétablit souvent tout seul. Une fois arrivé à failed, un appel peut se rétablir sans raccrocher en réessayant :
pc.onconnectionstatechange = () => {
if (pc.connectionState === 'failed') {
pc.restartIce();
}
};restartIce() fait que la prochaine offre rassemble les candidates et réessaie, votre signalisation doit donc porter cette nouvelle offre à l’autre côté.
Comment WordPlus Cloud s’en occupe
Sur WordPlus Cloud, un appel passe directement entre deux appareils quand c’est possible, par le relais le plus proche de chaque personne quand un pare-feu bloque ce chemin, et par nos serveurs multimédias quand même les relais ne peuvent pas passer, sans raccrocher. Il y a donc toujours un chemin suivant sur lequel se rabattre, et rien à faire tourner de votre côté. Comment nous connectons vos utilisateurs montre où sont ces serveurs, et connecter des utilisateurs entre plusieurs régions explique comment les appels les traversent.
Si un appel échoue sur notre réseau, le test de connexion montre si ce réseau atteint nos serveurs. La documentation des appels et les appels vidéo pour les applications montrent comment construire dessus.