Come risolvere i problemi di una videocamera WebRTC sulla rete locale

I guasti delle videocamere WebRTC possono sembrare improvvisi perché, prima che compaia il primo fotogramma, avvengono diversi passaggi. L’app ottiene le informazioni di segnalazione, raccoglie i candidati di rete, negozia una connessione peer e avvia un decoder video nativo. La telemetria può funzionare anche se una di queste fasi non riesce.

La Creality K2 e i percorsi di videocamera remota supportati usano WebRTC in Printer Tools. Non diagnosticarli come se fossero semplici URL MJPEG.

Printer Tools

Tutte le tue stampanti 3D in un'unica dashboard

Monitora le stampanti Bambu Lab, Klipper, OctoPrint, Creality, Snapmaker, Anycubic, Flashforge, Elegoo e Prusa da un'unica app

Disponibile su Android, iPhone, iPad e Mac, con app complementari per Apple Watch e Wear OS e accesso remoto opzionale tramite VPN, OctoEverywhere o Obico

Conferma la sorgente della segnalazione

Printer Tools deve ricevere l’offerta WebRTC, i dettagli della sessione o l’endpoint dalla stampante o dal servizio supportato. Una pagina web generica che mostra un video WebRTC non può essere incollata come URL di flusso.

Verifica il modello esatto della stampante e usa una versione aggiornata dell’app. L’instradamento per modello determina se Printer Tools debba tentare o meno WebRTC.

Separa telemetria e negoziazione della videocamera

Se la dashboard si aggiorna tramite l’API della stampante ma Live View non funziona, prendine nota. Ciò dimostra che una parte del percorso locale funziona e restringe il problema a segnalazione, candidati, flusso multimediale o decodifica.

Se non funziona nessuno dei due, correggi indirizzo della stampante e percorso di rete prima di interpretare i messaggi WebRTC.

Controlla ICE e i candidati di rete

Su una LAN semplice i peer possono collegarsi direttamente con candidati locali. Regole VLAN, VPN, più interfacce attive e isolamento dei client possono generare candidati irraggiungibili o bloccare il percorso multimediale dopo che la segnalazione è riuscita.

Esegui il test con telefono e stampante sulla LAN principale. Disattiva solo la VPN in conflitto per quel test, poi progetta un percorso esplicito invece di lasciare disattivate le protezioni.

Mantieni aggiornato il runtime nativo

La riproduzione WebRTC usa librerie native. Una build può compilare correttamente e fallire durante l’esecuzione se classi o binari nativi necessari sono stati rimossi durante l’ottimizzazione della release. Usa l’ultima versione ufficiale di Printer Tools prima di raccogliere una segnalazione di regressione.

Se l’app si chiude quando apri la videocamera, annota la versione esatta e la piattaforma, poi esporta il log dopo il riavvio. Non provocare ripetutamente il crash mentre è in corso un’azione critica per la stampa.

Interpreta i sintomi più comuni

un rifiuto immediato indica che l’endpoint o il servizio locale non è disponibile;
una connessione infinita indica che la segnalazione o la negoziazione ICE non si è conclusa;
audio o stato senza video indicano un problema della traccia multimediale o del decoder;
un video che parte e si blocca indica perdita di rete, pressione sul bitrate o uno stallo del decoder;
la chiusura dell’app indica un errore del runtime nativo che richiede i dettagli esatti della build.

Evita soluzioni di rete non sicure

Non esporre in modo ampio a Internet le porte di segnalazione o dei contenuti multimediali. Per l’accesso remoto usa il flusso di servizio supportato o una VPN affidabile. Una regola del router troppo permissiva può mascherare la diagnosi e al tempo stesso esporre gravemente la videocamera.

Per la configurazione specifica di Creality, consulta la guida alla videocamera WebRTC della K2.

Domande frequenti

WebRTC è solo un altro URL video?

No. Comprende segnalazione, negoziazione dei candidati e tracce multimediali, non solo un percorso di flusso statico.

Perché i dati della stampante funzionano mentre WebRTC no?

L’API della stampante e la connessione peer della videocamera usano servizi e flussi di rete diversi.

Devo inoltrare tutte le porte dei candidati?

No. Non aprire ampi intervalli pubblici. Ripara il percorso locale o usa il metodo di accesso remoto supportato.

Cosa devo includere in una segnalazione di crash?

Versione dell’app, piattaforma, modello di stampante, firmware, azione esatta e un nuovo log cifrato dopo il riavvio.

Fonti ufficiali: MDN — WebRTC API · RFC 8445 — ICE