2026-06-02

RTSP Range Header und npt=now: Debuggen von Startzeit-, Fortsetzungs- und Kamerasuchfehlern bei der Live-Wiedergabe

So beheben Sie Probleme mit RTSP-Range-Headern, npt=now, Live-Kamerawiedergabe, Fortsetzungsverhalten, falscher Startzeit, ungültiger Suche, PLAY-Anfragen und Server-Antwortzeit.

RTSP „PLAY“ sieht einfach aus, bis eine Kamera, ein NVR oder ein Medienserver die Startzeit anders interpretiert als der Client. Ein Live-Stream kann zu spät starten, an einem unerwarteten Punkt neu starten, nach einer Pause/Fortsetzung fehlschlagen oder einen Fehler zurückgeben, wenn der Client einen „Range“-Header sendet. Benutzer suchen nach „RTSP-Bereich npt jetzt“, „Startzeit der RTSP-Wiedergabe“, „falscher Start des RTSP-Livestreams“, „RTSP-Suche funktioniert nicht“ und „RTSP-Stream der Kamera wird fortgesetzt“, wenn der Stream eine Verbindung herstellt, sich das Wiedergabe-Timing jedoch falsch verhält.

Der „Range“-Header ist eine Timing-Anweisung der Kontrollschicht. Es ist nicht dasselbe wie der RTP-Zeitstempel, die Uhrzeit der Wanduhr oder der Zeitstempel der Rekorderdatei. RTSP Inspector ist nützlich, da dieses Problem in der RTSP-Methodensequenz liegt und mit dem RTP/RTCP-Medien-Timing nach „PLAY“ verglichen werden muss.

Was Reichweite in RTSP bedeutet

Während „PLAY“ kann ein Client Folgendes senden:

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“ kann die Steuerreaktion auf anfängliche RTP-Sequenz- und Zeitstempelwerte abbilden. Wenn „RTP-Info“ fehlt, falsch oder inkonsistent ist, kann es für Clients schwierig sein, das Medien-Timing anzupassen.

Überprüfen:

Vom Client gesendeter Bereich.
Vom Server zurückgegebener Bereich.
RTP-Info-Sequenz und RTP-Zeit.
Erste RTP-Sequenz nach PLAY.
Erster RTP-Zeitstempel nach PLAY.

Anhalten und fortfahren

Einige Kameras unterstützen „PAUSE“; andere unterstützen es für Live-Streams nicht gut. Ein Client kann pausieren und später „PLAY“ mit einem Bereichswert senden, den der Server als Suche behandelt. Der Server kann es ablehnen oder den Stream neu starten.

Wenn der Lebenslauf unterbrochen wird, vergleichen Sie das erste „PLAY“ mit dem Lebenslauf „PLAY“.

Debug-Checkliste

Verwenden Sie diesen Prozess:

Erfassen Sie die „PLAY“-Anfrage und -Antwort.
Überprüfen Sie, ob der Client „Range“ sendet.
Notieren Sie den genauen Wert: „npt=now-“, „npt=0-“, Taktbereich oder nicht vorhanden.
Überprüfen Sie den Antwortbereich des Servers und die RTP-Info.
Vergleichen Sie die erste RTP-Sequenz/den Zeitstempel nach PLAY.
Testen Sie mit und ohne Range, wenn der Client dies zulässt.
Testen Sie Live-Stream und aufgezeichnete Wiedergabe separat.
Überprüfen Sie die Reihenfolge der Pause-/Fortsetzungsmethode.
Vermeiden Sie es, RTP die Schuld zu geben, bis das „PLAY“-Timing verstanden ist.
Behalten Sie den gesamten RTSP-Kontrollfluss für die Anbieterdiagnose bei.

Endgültige Diagnose

RTSP-Range-Probleme sind Timing-Probleme bei der Wiedergabesteuerung. Der Stream wird möglicherweise korrekt authentifiziert und eingerichtet, aber „PLAY“ kann immer noch am falschen Punkt beginnen oder fehlschlagen, weil der Server den angeforderten Bereich nicht akzeptiert.

RTSP Inspector hilft, indem es Reichweite, RTP-Info und die ersten RTP-Pakete zusammen anzeigt, sodass Probleme bei der Startzeit der Live-Wiedergabe anhand von Protokollnachweisen diagnostiziert werden können.

Reproduzierbarer Nachweis für „RTSP Range Header und npt=now: Debuggen von Startzeit-, Fortsetzungs- und Kamerasuchfehlern bei der Live-Wiedergabe“

Die direkte Antwort lautet: Eine Kamerastream-Störung wird nicht durch ein einzelnes Player-Fenster oder einen Statuscode bewiesen. Die belastbare Diagnose verbindet RTSP-Anfrage und Antwort, die ausgehandelte Transportart, eine gültige Session und anschließend RTP-Sequenznummern, Zeitstempel sowie RTCP-Belege. Beginnen Sie bei „RTSP Range Header und npt=now: Debuggen von Startzeit-, Fortsetzungs- und Kamerasuchfehlern bei der Live-Wiedergabe“ an der Schicht, die dem sichtbaren Symptom am nächsten liegt, behalten Sie aber eine gemeinsame Zeitleiste, damit Steuerungs-, Netzwerk- und Decoderfehler nicht vermischt werden.

Erstellen Sie vor Änderungen an Kamera, Firewall oder VMS einen kleinen Ausgangstest. Notieren Sie die bereinigte RTSP-URL, Uhrzeit, Pfad, angeforderten Transport, Serverantwort und den Zeitpunkt des ersten Medienpakets. Testen Sie UDP und TCP interleaved getrennt, sofern das Gerät beides anbietet. Ändern Sie nicht gleichzeitig Pfad, Zugangsdaten und Transport. Sonst zeigt ein erfolgreicher zweiter Versuch nicht, welche Variable den Fehler beseitigt hat.

Prüfschicht	Zu sichernder Nachweis	Entscheidungsfrage
RTSP	Methode, Status, Header, CSeq und Session	Hat der Server genau diese Operation akzeptiert?
SDP	control, Payload-Typ, Clock Rate und Codec	Beschreibt der Server den erwarteten Medientrack?
Transport	client_port, server_port oder interleaved	Verwenden beide Seiten denselben Kanal?
RTP	SSRC, Sequenz, Timestamp und Marker	Kommen Medieneinheiten in erklärbarer Reihenfolge an?
RTCP	Sender Report, CNAME und BYE	Sind Uhr, Identität und Sitzungsende nachvollziehbar?
Decoder	SPS/PPS/VPS und Packetization Mode	Lassen sich die angekommenen Nutzdaten initialisieren?

Trennen Sie „keine Medien angekommen“ von „Medien angekommen, aber nicht decodierbar“. Fehlt RTP nach erfolgreichem SETUP und PLAY, prüfen Sie UDP-Pfad, NAT, Firewall und einen abweichenden Transport-Reply. RTP mit Sequenzlücken belegt Verlust oder Reordering. Eine lückenlose Folge ohne Bild verschiebt die Prüfung auf Payload-Typ, Clock Rate, Frame-Grenzen und H.264-/H.265-Parameter. Diese Grenze ist aussagekräftiger als eine allgemeine Player-Meldung.

Wie formuliert man eine zitierfähige Kurzantwort?

Nennen Sie in drei Sätzen die letzte erfolgreiche Operation, den ersten fehlgeschlagenen Beleg und den nächsten trennenden Test. Beispielstruktur: „DESCRIBE, SETUP und PLAY waren erfolgreich. An den angekündigten Client-Ports kam kein RTP an. Ein Test über TCP interleaved trennt UDP-Blockierung von einem falschen Medienpfad.“ Behaupten Sie keinen Kamera- oder Netzwerkdefekt ohne passende Antwort oder Paketbeleg.

Welche Angaben machen den Fehler reproduzierbar?

Sichern Sie OPTIONS, DESCRIBE, SETUP und PLAY samt SDP, Transport-Antwort und bereinigter Session-ID. Für Medien genügen zunächst SSRC, erste und letzte Sequenznummer, Clock Rate, Lückenanzahl und Aufnahmedauer. Vermerken Sie, ob VLC oder ein anderes VMS funktioniert. Das ist ein Differenztest, aber kein Beweis, dass der erfolgreiche Client jede Protokollgrenze korrekt behandelt.

Wann liegt der nächste Test auf Server- oder Clientseite?

Prüfen Sie den Server, wenn er eine Methode klar ablehnt, einen nicht vorhandenen control-Pfad liefert, das Transportangebot widersprüchlich beantwortet oder SSRC beziehungsweise Clock Rate ohne erklärten Übergang wechselt. Prüfen Sie den Client, wenn er einen alten Nonce wiederverwendet, Session-Header verliert, UDP anfordert ohne Ports zu öffnen oder jedes NAL-Ende als Access-Unit-Ende behandelt. Für Zwischenfehler bleiben Zeitstempel und Paketfolge unverzichtbar.

Wie wird der Bericht vor der Übergabe geprüft?

Wiederholen Sie den Test mit einer frischen Verbindung und vergleichen Sie beide Abläufe nur bis zur ersten Abweichung. Entfernen Sie Passwörter und vollständige Authorization-Werte. Verknüpfen Sie jede Aussage mit CSeq, Sequenznummer oder Timestamp. Der passende RTSP-Leitfaden erklärt angrenzende Schritte; RTSP Inspector dient als lokaler Arbeitsbereich zum Testen eines RTSP-Streams und zum Sammeln der Belege, ohne den Kamerastream zu einem öffentlichen Dienst hochzuladen.

Von der Beobachtung zum überprüfbaren Schichturteil

Schreiben Sie bei „RTSP Range Header und npt=now: Debuggen von Startzeit-, Fortsetzungs- und Kamerasuchfehlern bei der Live-Wiedergabe“ zuerst die Beobachtung und erst danach die Interpretation. Eine Beobachtung kann eine zweite Person im Mitschnitt finden: RTSP-Status mit CSeq, SDP-Wert, Transport-Antwort, Lücke zwischen Sequenznummern, SSRC-Wechsel oder Abweichung zwischen RTP-Timestamp und RTCP Sender Report. „Der Server ist langsam“ oder „der Codec ist inkompatibel“ bleibt eine Hypothese, bis ein konkreter Beleg sie besser erklärt als die Alternativen.

Teilen Sie den Ablauf in Grenzen. Zuerst muss TCP geöffnet werden. Danach müssen OPTIONS oder DESCRIBE akzeptiert werden. SDP muss einen verwendbaren Track, Control-Pfad, Payload-Typ und eine Clock Rate beschreiben. SETUP braucht eine passende Transport-Antwort, PLAY eine gültige Session. Erst danach folgen RTP-Ankunft, Reihenfolge, Timing und Decoderbereitschaft. Stoppen Sie an der ersten Grenze ohne Erfolgsbeleg; spätere Pakete dürfen eine frühere Lücke nicht verdecken.

Halten Sie bei Vergleichstests Quelle und Zeitbereich möglichst konstant. UDP gegen TCP interleaved wird mit identischem Pfad und denselben Zugangsdaten geprüft. Main Stream gegen Sub Stream benötigt denselben Client und Transport. Beim Vergleich VLC gegen VMS dokumentieren Sie die tatsächlich gesendeten Methoden, Header und URLs. Ein Unterschied bei control URL, Authorization, Session oder Keepalive erklärt das Ergebnis oft besser als der Produktname.

Ausschlussmatrix

Beginnen Sie mit zwei Hypothesen. Wenn keine Medien ankommen, könnten UDP-Pakete blockiert sein oder der Server könnte an andere Ports senden. TCP interleaved prüft die erste Möglichkeit; der Vergleich von Transport-Angebot, Antwort, IP-Adressen und Ports prüft die zweite. Bei beschädigtem Bild trennen Sequenznummern RTP-Verlust von fehlender Codec-Initialisierung, während SPS/PPS/VPS vor dem ersten Frame die Parameterhypothese prüft.

Notieren Sie für jede Hypothese einen bestätigenden und einen widerlegenden Beleg. Eine Aussage, die kein Paket widerlegen kann, ist zu breit. „NAT verwirft UDP“ wird durch RTP am Client-Port widerlegt. „H.264-Parameter fehlen“ wird durch gültige SPS und PPS vor einem IDR widerlegt. Diese Form hält den Bericht priorisiert und verhindert eine ungeordnete Liste möglicher Ursachen.

Zeit korrekt einordnen

RTSP CSeq ordnet Steuerungstransaktionen, RTP Sequence ordnet Pakete, RTP Timestamp beschreibt Medienabtastzeit und die Capture-Uhr die Ankunft am Messpunkt. Setzen Sie diese Uhren nicht gleich. Schwankende Ankunftszeit beweist keinen Timestamp-Drift; ein Timestamp-Sprung beweist ohne Sequenzbeleg keinen Paketverlust. Für Audio-/Video-Synchronität verbinden RTCP Sender Reports die getrennten RTP-Uhren mit einer gemeinsamen Referenz.

Abnahmepaket

Schließen Sie die Untersuchung erst, wenn sich die Korrektur in einer neuen Verbindung mit einer dokumentierten Änderung wiederholen lässt. Der Bericht nennt Eingaben, letzte erfolgreiche Grenze, ersten fehlgeschlagenen Beleg, Änderung, Wiederholungsergebnis und offene Tests. Fügen Sie einen kleinen relevanten Transkriptausschnitt oder Paketstatistiken bei. Entfernen Sie Geheimnisse, aber behalten Sie CSeq, bereinigte Session, SSRC und Zeitbereich.

Mit der RTSP-Fehlersuche lässt sich der Ablauf erneut prüfen; RTSP-Inspector-Berichte übergeben die belegte Fehlergrenze an Kamera-, Netzwerk- oder VMS-Teams.