2026-06-02

En-tête de plage RTSP et npt=now : débogage des erreurs d'heure de début, de reprise et de recherche de caméra en direct

Comment dépanner les en-têtes de plage RTSP, npt=maintenant, la lecture de la caméra en direct, le comportement de reprise, l'heure de démarrage incorrecte, la recherche invalide, les requêtes PLAY et le timing de réponse du serveur.

RTSP PLAY semble simple jusqu'à ce qu'une caméra, un NVR ou un serveur multimédia interprète l'heure de début différemment du client. Un flux en direct peut démarrer tardivement, redémarrer à partir d'un point inattendu, échouer après une pause/reprise ou renvoyer une erreur lorsque le client envoie un en-tête « Range ». Les utilisateurs recherchent "RTSP Range npt now", "RTSP PLAY start time", "RTSP live stream mauvais démarrage", "RTSP seek not working" et "caméra reprise RTSP stream" lorsque le flux se connecte mais que le timing de lecture se comporte incorrectement.

L'en-tête « Range » est une instruction de synchronisation de la couche de contrôle. Ce n'est pas la même chose que l'horodatage RTP, l'heure de l'horloge murale ou l'horodatage du fichier enregistreur. L'inspecteur RTSP est utile car ce problème se situe dans la séquence de la méthode RTSP et doit être comparé au timing multimédia RTP/RTCP après « PLAY ».

Que signifie la plage dans RTSP

Pendant PLAY, un client peut envoyer :

PLAY rtsp://camera/stream RTSP/1.0
Session: 12345678
Range: npt=now-

For a live stream, npt=now- usually means "start playing from the current live point." Some clients omit the Range header. Some send npt=0.000-. Some NVRs use clock-based ranges for recorded playback.

Different RTSP servers vary in how strictly they interpret these values.

Live stream vs recorded stream

Live streams and recorded streams have different expectations:

Live camera stream: current live media point.
NVR playback: requested recording time range.
Media file: offset into stored content.
Replay server: session-specific timeline.

A Range value that is valid for a file may be invalid for a live camera. A Range value that works for one NVR may not work for another vendor.

Common symptoms

Range-related problems include:

PLAY fails only when Range is present.
Stream starts but with long delay.
Resume after pause fails.
Client receives old buffered video.
NVR playback starts at wrong time.
RTP timestamps jump after resume.
Camera ignores Range but returns 200 OK.
Server returns invalid Range response.

The player may show this as buffering or black video, but the root evidence is in PLAY.

Server response matters

After PLAY, the server may return a Range header:

RTSP/1.0 200 OK
Range: npt=0.000-
RTP-Info: url=...;seq=...;rtptime=...

RTP-Info peut mapper la réponse de contrôle aux valeurs initiales de la séquence RTP et de l'horodatage. Si « RTP-Info » est manquant, erroné ou incohérent, les clients peuvent avoir du mal à aligner le timing des médias.

Inspecter:

Gamme envoyée par le client.
Plage renvoyée par le serveur.
Séquence RTP-Info et rtptime.
Première séquence RTP après PLAY.
Premier horodatage RTP après PLAY.

Pause et reprise

Certaines caméras prennent en charge « PAUSE » ; d'autres ne le prennent pas bien en charge pour les diffusions en direct. Un client peut faire une pause et envoyer plus tard « PLAY » avec une valeur Range que le serveur traite comme une recherche. Le serveur peut le rejeter ou redémarrer le flux.

Si la reprise s'interrompt, comparez le premier « PLAY » avec la reprise « PLAY ».

Liste de contrôle de débogage

Utilisez ce processus :

Capturez la demande et la réponse « PLAY ».
Vérifiez si le client envoie « Range ».
Enregistrez la valeur exacte : npt=now-, npt=0-, plage d'horloge ou absent.
Vérifiez la plage de réponse du serveur et les informations RTP.
Comparez la première séquence/horodatage RTP après PLAY.
Testez avec et sans Range si le client le permet.
Testez le flux en direct et la lecture enregistrée séparément.
Vérifiez la séquence de la méthode pause/reprise.
Évitez de blâmer RTP jusqu'à ce que le timing « PLAY » soit compris.
Préservez l’intégralité du flux de contrôle RTSP pour le diagnostic du fournisseur.

Diagnostic final

Les problèmes de plage RTSP sont des problèmes de synchronisation de contrôle de lecture. Le flux peut s'authentifier et être configuré correctement, mais « PLAY » peut toujours démarrer à partir du mauvais point ou échouer car le serveur n'accepte pas la plage demandée.

RTSP Inspector aide en affichant ensemble la plage, les informations RTP et les premiers paquets RTP, afin que les problèmes d'heure de début de lecture en direct puissent être diagnostiqués à partir des preuves de protocole.

Preuve reproductible pour « En-tête de plage RTSP et npt=now : débogage des erreurs d'heure de début, de reprise et de recherche de caméra en direct »

La réponse directe est qu’un écran noir ou un code isolé ne prouve pas l’origine d’une panne de caméra. Un diagnostic fiable relie requête et réponse RTSP, transport négocié, session valide, puis numéros de séquence RTP, horodatages et éléments RTCP. Pour « En-tête de plage RTSP et npt=now : débogage des erreurs d'heure de début, de reprise et de recherche de caméra en direct », partez de la couche la plus proche du symptôme, tout en conservant une chronologie unique afin de ne pas confondre contrôle, réseau et décodage.

Avant de modifier caméra, pare-feu ou VMS, établissez un test de référence. Notez l’URL RTSP sans mot de passe, l’heure, le chemin, le transport demandé, la réponse du serveur et l’arrivée du premier paquet média. Testez séparément UDP et TCP interleaved si l’équipement les propose. Ne changez pas à la fois chemin, identifiants et transport : un second essai réussi ne dirait pas quelle variable a corrigé l’écart.

Couche	Preuve à conserver	Question de décision
RTSP	méthode, statut, en-têtes, CSeq et Session	Le serveur accepte-t-il précisément l’opération ?
SDP	control, payload type, clock rate et codec	La piste décrite est-elle celle attendue ?
Transport	client_port, server_port ou interleaved	Les deux extrémités utilisent-elles le même canal ?
RTP	SSRC, séquence, timestamp et marker	Les unités arrivent-elles dans un ordre explicable ?
RTCP	sender report, CNAME et BYE	Horloge, identité et fin sont-elles traçables ?
Décodeur	SPS/PPS/VPS et packetization mode	Le payload reçu permet-il l’initialisation ?

Séparez « aucun média reçu » de « média reçu mais indécodable ». L’absence de RTP après SETUP et PLAY réussis dirige vers UDP, NAT, pare-feu ou une réponse Transport différente de l’offre. Des trous de séquence prouvent perte ou réordonnancement. Une séquence continue sans image déplace l’enquête vers payload type, fréquence d’horloge, limites d’image et paramètres H.264 ou H.265. Cette frontière est plus utile qu’un message générique du lecteur.

Comment rédiger une réponse directement réutilisable ?

Écrivez trois phrases : dernière opération réussie, première preuve en échec, prochain test discriminant. Exemple : « DESCRIBE, SETUP et PLAY réussissent ; aucun RTP n’arrive aux ports annoncés ; un essai TCP interleaved séparera blocage UDP et mauvais chemin média. » N’accusez ni caméra ni réseau sans réponse ou paquet qui matérialise cette limite.

Quelles données rendent le cas reproductible ?

Conservez OPTIONS, DESCRIBE, SETUP et PLAY, le SDP, la réponse Transport et l’identifiant Session nettoyé. Pour RTP, relevez SSRC, première et dernière séquence, clock rate, nombre de trous et durée. Mentionnez le résultat dans VLC ou un autre VMS comme test différentiel, pas comme preuve que le client qui fonctionne respecte toutes les frontières.

Quand tester le serveur ou le client ?

Examinez le serveur s’il refuse une méthode, fournit une URL control absente, renvoie un transport incompatible ou change SSRC ou horloge sans transition. Examinez le client s’il réutilise un nonce expiré, perd Session, demande UDP sans ouvrir les ports ou assimile chaque fin de NAL à une fin d’access unit. Entre les deux, paquet et heure doivent accompagner chaque conclusion.

Comment valider le rapport ?

Recommencez avec une connexion neuve et comparez les chronologies jusqu’à la première divergence. Retirez mots de passe et valeurs Authorization complètes. Reliez chaque conclusion à CSeq, séquence ou timestamp. La documentation RTSP associée couvre les étapes voisines ; RTSP Inspector permet de tester un flux RTSP et de collecter localement les preuves sans téléverser la vidéo vers un service public.

De l’observation au verdict par couche

Pour « En-tête de plage RTSP et npt=now : débogage des erreurs d'heure de début, de reprise et de recherche de caméra en direct », écrivez d’abord l’observation puis son interprétation. Une observation peut être retrouvée dans la capture : statut RTSP lié à CSeq, valeur SDP, réponse Transport, trou de séquence, changement de SSRC ou différence entre RTP timestamp et RTCP sender report. « Le serveur est lent » ou « le codec est incompatible » reste une hypothèse tant qu’un élément précis ne la rend pas plus probable que les autres.

Découpez le parcours en frontières. TCP doit s’ouvrir, puis OPTIONS ou DESCRIBE être accepté. Le SDP doit décrire une piste exploitable, son control URL, payload type et clock rate. SETUP exige une réponse Transport compatible et PLAY une Session valide. Viennent ensuite arrivée RTP, ordre, temps et préparation du décodeur. Arrêtez-vous à la première frontière sans preuve de réussite ; une donnée ultérieure ne doit pas masquer une lacune antérieure.

Gardez source et intervalle constants pendant les comparaisons. UDP et TCP interleaved utilisent le même chemin et les mêmes identifiants. Main stream et sub stream gardent client et transport. Pour VLC face à un VMS, consignez méthodes, en-têtes et URL réels. Une différence de control URL, Authorization, Session ou keepalive explique parfois davantage que le nom de l’application.

Matrice d’exclusion

Commencez par deux hypothèses. Sans média, UDP peut être bloqué ou le serveur peut envoyer vers d’autres ports. TCP interleaved teste la première ; comparer offre et réponse Transport, adresses et ports teste la seconde. Pour une image corrompue, les séquences RTP séparent perte et initialisation incomplète, tandis que SPS/PPS/VPS avant la première image teste les paramètres codec.

Pour chaque hypothèse, notez une preuve favorable et une preuve qui pourrait la réfuter. Une affirmation qu’aucun paquet ne peut contredire est trop large. « Le NAT supprime UDP » est réfuté par RTP au port client. « Les paramètres H.264 manquent » est réfuté par SPS et PPS valides avant IDR. Le rapport reste ainsi ordonné plutôt qu’une liste de possibilités.

Interpréter le temps sans surconclure

RTSP CSeq ordonne les transactions, RTP sequence les paquets, RTP timestamp le temps d’échantillonnage, et l’horloge de capture l’arrivée au point observé. Ne les confondez pas. Une arrivée irrégulière ne prouve pas une dérive ; un saut timestamp ne prouve pas une perte sans séquence. Les RTCP sender reports relient les horloges RTP audio et vidéo à une référence commune.

Dossier de recette

Fermez l’enquête lorsque la correction se répète sur une connexion neuve avec un changement documenté. Le rapport indique entrées, dernière frontière réussie, première preuve en échec, modification, résultat et tests ouverts. Joignez un court extrait de transcription ou des statistiques ciblées. Masquez les secrets, mais gardez CSeq, Session nettoyée, SSRC et plage temporelle.

La procédure de dépannage RTSP reconstruit le parcours ; les rapports RTSP Inspector transmettent la frontière prouvée aux équipes caméra, réseau ou VMS.