2026-06-03

Debug RTCP CNAME e sincronizzazione audio/video RTSP: timestamp RTP, rapporti mittente, sincronizzazione labiale e deriva traccia

Come eseguire il debug di RTCP CNAME, mappatura timestamp RTP, rapporti mittente, sincronizzazione audio/video, deriva della sincronizzazione labiale e problemi di temporizzazione della fotocamera RTSP multitraccia.

I flussi RTSP con audio e video possono connettersi correttamente ed essere comunque inutilizzabili se audio e video si allontanano. Gli utenti cercano "video audio RTSP non sincronizzato", "sincronizzazione labiale RTCP CNAME", "deriva del timestamp RTP", "ritardo audio della fotocamera", "sincronizzazione del rapporto mittente RTCP" e "video RTSP prima dell'audio" quando la riproduzione inizia ma i tempi sembrano errati.

RTSP Inspector è utile perché si tratta di un problema di temporizzazione del protocollo. La prova importante non sono solo i media decodificati. È la relazione tra timestamp RTP, rapporti mittente RTCP, valori SSRC, valori CNAME, orologi di traccia e tempi di arrivo.

Perché i timestamp RTP da soli non sono sufficienti

I timestamp RTP sono relativi a ciascun orologio multimediale. Una traccia video può utilizzare un clock di 90 kHz. Una traccia audio può utilizzare 8 kHz, 16 kHz, 44,1 kHz o 48 kHz a seconda del codec e dell'SDP.

Ciò significa che questo non è sufficiente:

video RTP timestamp: 900000
audio RTP timestamp: 480000

What RTCP Sender Reports provide

A useful report should show:

What CNAME is for

Failures include:

Lip sync drift

Immediate offset suggests:

Gradual drift suggests:

Wrong clock rate in SDP

Evidence:

RTCP blocked by transport path

Symptoms:

Gateway and restreamer issues

Problems include:

Debug checklist

Use this workflow:

Final diagnosis

Prova riproducibile per «Debug RTCP CNAME e sincronizzazione audio/video RTSP: timestamp RTP, rapporti mittente, sincronizzazione labiale e deriva traccia»

La risposta diretta è che una schermata nera o un solo codice non dimostra l’origine del guasto. Una diagnosi affidabile collega richiesta e risposta RTSP, trasporto negoziato, sessione valida e poi numeri di sequenza RTP, timestamp e segnali RTCP. Per «Debug RTCP CNAME e sincronizzazione audio/video RTSP: timestamp RTP, rapporti mittente, sincronizzazione labiale e deriva traccia» parti dal livello più vicino al sintomo visibile, ma conserva una cronologia comune per non confondere controllo, rete e decodifica.

Prima di cambiare camera, firewall o VMS, crea un test di base piccolo. Registra URL RTSP senza password, ora, percorso, trasporto richiesto, risposta del server e momento del primo pacchetto multimediale. Prova separatamente UDP e TCP interleaved quando disponibili. Non cambiare insieme percorso, credenziali e trasporto: se il secondo tentativo funziona, devi poter identificare la variabile decisiva.

Livello	Evidenza da conservare	Domanda
RTSP	metodo, stato, header, CSeq e Session	Il server ha accettato proprio questa operazione?
SDP	control, payload type, clock rate e codec	È descritta la traccia attesa?
Transport	client_port, server_port o interleaved	I due estremi usano lo stesso canale?
RTP	SSRC, sequenza, timestamp e marker	Le unità arrivano in ordine spiegabile?
RTCP	sender report, CNAME e BYE	Orologio, identità e fine sono tracciabili?
Decoder	SPS/PPS/VPS e packetization mode	Il payload ricevuto può inizializzare il decoder?

Separa «nessun media ricevuto» da «media ricevuto ma non decodificabile». Se RTP manca dopo SETUP e PLAY riusciti, verifica UDP, NAT, firewall e risposta Transport. Buchi nella sequenza provano perdita o riordinamento. Una sequenza continua senza immagine sposta l’indagine su payload type, clock rate, confini del frame e parametri H.264 o H.265. Questo confine è più utile del messaggio generico del player.

Come si scrive una risposta citabile?

Usa tre frasi: ultima operazione riuscita, prima evidenza fallita, prossimo test che separa due cause. Esempio: «DESCRIBE, SETUP e PLAY riescono; nessun RTP arriva alle porte annunciate; una prova TCP interleaved separerà blocco UDP e percorso media errato». Non attribuire il guasto a camera o rete senza una risposta o un pacchetto che dimostri il confine.

Quali dati rendono il caso riproducibile?

Conserva OPTIONS, DESCRIBE, SETUP e PLAY, SDP, risposta Transport e Session ripulita. Per RTP annota SSRC, prima e ultima sequenza, clock rate, buchi e durata. Indica se VLC o un altro VMS funziona, ma usalo come confronto controllato, non come prova che il client riuscito interpreti correttamente ogni regola.

Quando controllare server o client?

Controlla il server se rifiuta un metodo, fornisce un control URL assente, restituisce un trasporto incompatibile o cambia SSRC o clock senza transizione. Controlla il client se riusa un nonce scaduto, perde Session, richiede UDP senza aprire le porte o tratta ogni fine NAL come fine access unit. Se il difetto è intermedio, pacchetto e tempo devono accompagnare ogni conclusione.

Come verificare il rapporto?

Ripeti da una connessione nuova e confronta le cronologie fino alla prima differenza. Rimuovi password e valori Authorization completi. Collega ogni conclusione a CSeq, sequenza o timestamp. Segui la guida RTSP correlata e usa RTSP Inspector per testare uno stream RTSP e raccogliere prove localmente, senza caricare il video su un servizio pubblico.

Dall’osservazione al verdetto per livello

In «Debug RTCP CNAME e sincronizzazione audio/video RTSP: timestamp RTP, rapporti mittente, sincronizzazione labiale e deriva traccia» scrivi prima l’osservazione e poi l’interpretazione. Un’altra persona deve poter ritrovare l’osservazione nella cattura: stato RTSP legato a CSeq, valore SDP, risposta Transport, buco di sequenza, cambio SSRC o differenza tra RTP timestamp e RTCP sender report. “Il server è lento” o “il codec è incompatibile” resta un’ipotesi finché una prova precisa non la rende migliore delle alternative.

Dividi il percorso in confini. Prima si apre TCP, poi vengono accettati OPTIONS o DESCRIBE. SDP deve descrivere una traccia utilizzabile con control URL, payload type e clock rate. SETUP richiede una risposta Transport compatibile e PLAY una Session valida. Solo dopo vengono arrivo RTP, ordine, tempo e preparazione del decoder. Fermati al primo confine senza prova di successo.

Mantieni fonte e intervallo costanti nei confronti. UDP contro TCP interleaved usa lo stesso percorso e le stesse credenziali. Main stream contro sub stream conserva client e trasporto. Confrontando VLC e VMS, registra metodi, header e URL reali; differenze in control URL, Authorization, Session o keepalive possono spiegare il risultato più del nome del programma.

Matrice di esclusione

Parti da due ipotesi. Se non arriva media, UDP può essere bloccato oppure il server può inviare ad altre porte. TCP interleaved verifica la prima; confrontare offerta e risposta Transport, IP e porte verifica la seconda. Per immagine corrotta, la sequenza RTP separa perdita da inizializzazione incompleta, mentre SPS/PPS/VPS prima del primo frame verifica i parametri codec.

Per ogni ipotesi annota una prova favorevole e una che potrebbe smentirla. Un’affermazione che nessun pacchetto può negare è troppo ampia. “NAT elimina UDP” è smentita da RTP sulla porta client. “Mancano parametri H.264” è smentita da SPS e PPS validi prima di IDR. Il rapporto resta così prioritario.

Leggere il tempo senza conclusioni eccessive

RTSP CSeq ordina transazioni, RTP sequence ordina pacchetti, RTP timestamp esprime il tempo di campionamento e l’orologio di cattura l’arrivo al punto osservato. Non sono lo stesso orologio. Variazione di arrivo non prova drift; salto timestamp non prova perdita senza sequenza. RTCP sender report collega orologi RTP audio e video a un riferimento comune.

Pacchetto di accettazione

Chiudi il caso quando la correzione si ripete su una connessione nuova con una sola modifica documentata. Il rapporto indica input, ultimo confine riuscito, prima prova fallita, modifica, risultato e test aperti. Allega un breve transcript o statistiche mirate. Nascondi i segreti, ma conserva CSeq, Session ripulita, SSRC e intervallo.

Usa la risoluzione problemi RTSP per ricostruire il flusso e i report di RTSP Inspector per consegnare il confine al team camera, rete o VMS.

Registro della modifica e test di regressione

Trasforma la correzione in un registro ripetibile: valore precedente e nuovo, posizione dell’impostazione, ora della riconnessione ed effetto atteso sui pacchetti. Con TCP interleaved non basta “ora compare l’immagine”: i media non devono più dipendere da porte UDP separate e devono apparire sui canali negoziati. Se cambia control URL, SETUP deve usare il nuovo percorso e PLAY e keepalive devono conservare la stessa Session.

Quando è sicuro, esegui un controllo negativo. Ripristina il vecchio valore in un ambiente di prova o confronta una cattura precedente con input uguali; dovrebbe fallire lo stesso confine. Questo impedisce di scambiare un riavvio casuale, una cache o una modifica di rete non documentata per la soluzione. Su una camera di produzione usa evidenza storica e non provocare intenzionalmente l’interruzione.

Mantieni la connessione oltre i normali timeout keepalive e Session. Osserva OPTIONS o GET_PARAMETER e verifica coerenza di CSeq e Session. Per RTP confronta perdita, duplicati e riordinamento in finestre uguali prima e dopo. Per il codec apri una connessione nuova e attendi il primo IDR; un decoder già inizializzato può nascondere parametri di avvio mancanti.

Limita l’affermazione: “main stream TCP verificato dieci minuti con questo client” è migliore di “RTSP riparato”. Specifica traccia, trasporto, codec, client e durata. Audio, sub stream e riconnessione dopo perdita di rete restano aperti se non sono stati provati.

Separa fatti e raccomandazione. I fatti sono risposte, pacchetti e misure; la raccomandazione propone una modifica a camera, firewall o client. Un altro team deve poter accettare i fatti anche scegliendo una cura diversa. Chiudi con responsabile, azione successiva e criterio, consegnando il breve intervallo con la guida ai report RTSP.

Esegui un’ultima revisione su una copia esportata, non affidandoti alla memoria. Un’altra persona deve ricavare dall’intervallo, dai campi e dai link interni l’ultima operazione riuscita, il primo pacchetto che cambia il verdetto e il motivo che esclude un’alternativa. Registra versioni di camera e client quando note, ma non trasformare la sola versione nella causa. Indica anche il punto di cattura: un pacchetto assente presso il client può essere presente all’uscita del server. Se due punti differiscono, il tratto fra essi è il prossimo ambito. Chiudi con data, durata e risultato esplicito: superato, fallito o non deciso con motivazione. Conserva inoltre il filtro di cattura e lo scarto fra gli orologi dei due host. Senza questi dati, due tracce dello stesso evento possono sembrare diverse soltanto perché sono state osservate con filtri o riferimenti temporali differenti.