Comment dépanner une caméra WebRTC sur un réseau local

Les pannes de caméra WebRTC peuvent sembler soudaines, car plusieurs étapes ont lieu avant l’affichage de la première image. L’app obtient les informations de signalisation, collecte les candidats réseau, négocie une connexion pair à pair et démarre un décodeur vidéo natif. La télémétrie peut fonctionner alors que l’une de ces étapes échoue.

La Creality K2 et les chemins de caméra à distance pris en charge utilisent WebRTC dans Printer Tools. Ne les dépannez pas comme s’il s’agissait de simples URL MJPEG.

Printer Tools

Toutes vos imprimantes 3D dans un seul tableau de bord

Surveillez vos imprimantes Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo et Prusa depuis une seule application

Disponible sur Android, iPhone, iPad et Mac, avec des apps compagnons pour Apple Watch et Wear OS et un accès à distance facultatif via VPN, OctoEverywhere ou Obico

Confirmez la source de signalisation

Printer Tools doit recevoir l’offre WebRTC, les détails de session ou le point d’accès de l’imprimante ou du service pris en charge. Une page web générique qui affiche du WebRTC ne peut pas être collée comme URL de flux.

Vérifiez le modèle exact de l’imprimante et utilisez une version récente de l’app. Le routage par modèle détermine si Printer Tools doit tenter WebRTC.

Séparez télémétrie et négociation de la caméra

Si le tableau de bord se met à jour via l’API de l’imprimante mais que Live View échoue, notez-le. Cela prouve qu’une partie du chemin local fonctionne et limite le problème à la signalisation, aux candidats, au flux média ou au décodage.

Si les deux échouent, corrigez l’adresse de l’imprimante et la route réseau avant d’interpréter les messages WebRTC.

Vérifiez ICE et les candidats réseau

Sur un LAN simple, les pairs peuvent se connecter directement avec des candidats locaux. Des règles VLAN, des VPN, plusieurs interfaces actives et l’isolation des clients peuvent produire des candidats injoignables ou bloquer le flux média une fois la signalisation réussie.

Testez avec le téléphone et l’imprimante sur le LAN principal. Désactivez uniquement le VPN en conflit pendant ce test, puis concevez une route explicite au lieu de laisser les protections désactivées.

Gardez l’environnement natif à jour

La lecture WebRTC utilise des bibliothèques natives. Une version peut compiler correctement et échouer à l’exécution si des classes ou binaires natifs nécessaires ont été supprimés lors de l’optimisation de la version publiée. Utilisez la dernière version officielle de Printer Tools avant de préparer un rapport de régression.

Si l’app se ferme à l’ouverture de la caméra, notez la version exacte et la plateforme, puis exportez le journal après la relance. Ne déclenchez pas le plantage à répétition pendant une action critique pour l’impression.

Interprétez les symptômes courants

un refus immédiat suggère que le point d’accès ou le service local est indisponible ;
une connexion interminable suggère que la signalisation ou la négociation ICE n’a pas abouti ;
de l’audio ou un état sans vidéo suggère un problème de piste média ou de décodeur ;
une vidéo qui démarre puis se fige suggère une perte réseau, une pression sur le débit ou un blocage du décodeur ;
la fermeture de l’app suggère une défaillance de l’environnement natif qui nécessite les détails exacts de la version.

Évitez les contournements réseau dangereux

N’exposez pas largement les ports de signalisation ou de média à Internet. Pour l’accès à distance, utilisez le flux de service pris en charge ou un VPN de confiance. Une règle de routeur trop permissive peut masquer le diagnostic tout en exposant gravement la caméra.

Pour la configuration propre à Creality, consultez le guide de la caméra WebRTC de la K2.

Questions fréquentes

WebRTC est-il simplement une autre URL vidéo ?

Non. Il comprend la signalisation, la négociation des candidats et des pistes média, pas seulement un chemin de flux statique.

Pourquoi les données de l’imprimante fonctionnent-elles alors que WebRTC échoue ?

L’API de l’imprimante et la connexion pair à pair de la caméra utilisent des services et des flux réseau différents.

Dois-je rediriger chaque port candidat ?

Non. N’ouvrez pas de larges plages publiques. Réparez la route locale ou utilisez la méthode d’accès à distance prise en charge.

Que dois-je inclure dans un rapport de plantage ?

La version de l’app, la plateforme, le modèle d’imprimante, le firmware, l’action exacte et un nouveau journal chiffré après la relance.

Sources officielles: MDN — WebRTC API · RFC 8445 — ICE