2026-06-02

ONVIF fonctionne mais l'URL RTSP échoue : recherche du véritable chemin du flux de la caméra

Pourquoi la découverte ONVIF peut fonctionner lorsque le flux RTSP échoue et comment déboguer les profils de caméra, les URL de médias, l'authentification, le transport et les preuves SDP.

Il est courant qu'une caméra IP apparaisse correctement dans la découverte ONVIF alors que l'URL RTSP échoue toujours. L'appareil est visible sur le réseau, le nom et le modèle de la caméra sont détectés, peut-être même les profils sont répertoriés, mais le flux vidéo lui-même ne s'ouvre pas. Les utilisateurs recherchent « ONVIF fonctionne mais RTSP échoue », « caméra découverte mais pas de vidéo RTSP » ou « comment trouver l'URL RTSP à partir d'ONVIF », car le succès de la découverte donne l'impression qu'il devrait garantir le succès du streaming.

Ce n’est pas le cas.

ONVIF et RTSP sont liés dans de nombreux flux de travail de caméra, mais il ne s'agit pas du même protocole et ils ne prouvent pas la même chose. ONVIF peut vous indiquer qu'une caméra existe et peut fournir un profil multimédia. RTSP doit toujours s'authentifier, décrire le flux, négocier le transport, configurer les pistes RTP et livrer les paquets multimédias.

RTSP Inspector se concentre sur cette seconde moitié : que se passe-t-il réellement lorsqu'une URL RTSP spécifique est utilisée.

Ce que prouve ONVIF

La découverte ONVIF peut prouver que :

La caméra répond à WS-Discovery.
La caméra expose un point de terminaison de service ONVIF.
Le client peut accéder à l'interface de gestion des caméras.
La caméra peut avoir un ou plusieurs profils multimédias.
L'appareil peut signaler les URI de flux via les services multimédias ONVIF.

C’est utile, mais ce n’est pas la même chose que prouver que le flux RTSP fonctionne. La découverte ONVIF peut utiliser un port différent, un comportement d'authentification différent et un chemin de service différent de celui de RTSP.

Une caméra peut réussir la découverte ONVIF et échouer néanmoins RTSP pour les raisons suivantes :

RTSP est désactivé dans les paramètres de la caméra.
Le compte ONVIF ne dispose pas de l'autorisation RTSP.
L’URI du flux renvoyé est incomplet ou interne uniquement.
Le port RTSP est bloqué par un pare-feu.
La caméra nécessite un transport TCP entrelacé mais le client essaie UDP.
Le profil pointe vers H.265 mais le client attend du H.264.
Le chemin du canal NVR est erroné.
La caméra renvoie SDP mais n'envoie aucun paquet RTP.

L'URI du flux ONVIF peut ne pas être directement utilisable

Certaines caméras renvoient un URI RTSP via ONVIF qui semble utilisable mais doit encore être modifié. Par exemple:

rtsp://192.168.1.50/Streaming/Channels/101

The real usable URL may need:

ONVIF profile does not guarantee codec support

The symptom may be:

RTSP Inspector helps by separating the layers:

RTSP transport can fail after ONVIF succeeds

This is common when:

Authentication can differ between ONVIF and RTSP

You may see:

RTSP/1.0 401 Unauthorized
WWW-Authenticate: Digest realm="IP Camera", nonce="..."

même si la découverte ONVIF a fonctionné. Cela signifie que le service RTSP demande des informations d'identification. Si le client envoie des informations d'identification et que la caméra continue de renvoyer « 401 », vérifiez les autorisations du compte, l'authentification Digest, le codage d'URL et les droits de chaîne.

Les NVR rendent cela plus confus car le périphérique ONVIF peut être le NVR, tandis que le chemin du flux RTSP fait référence à un canal de caméra derrière le NVR. Le compte peut être autorisé à interroger le NVR mais pas à diffuser le flux principal du canal 1.

Confusion du flux principal et du sous-flux

De nombreuses caméras exposent plusieurs profils :

Flux principal : haute résolution, débit binaire élevé, souvent H.265.
Sous-flux : résolution inférieure, débit binaire inférieur, souvent H.264.
Flux mobile : petite taille d’image et fréquence d’images inférieure.

ONVIF peut renvoyer l'un de ces profils par défaut. L'URL RTSP copiée à partir d'un forum ou d'un PDF d'un fournisseur peut pointer vers un autre. Si le flux principal est H.265 mais que le client ne prend en charge que H.264, le sous-flux peut fonctionner tandis que le flux principal échoue.

Les recherches telles que « Le flux principal RTSP ne fonctionne pas, le sous-flux fonctionne » appartiennent souvent à cette catégorie. Le problème n'est pas la découverte. Il s'agit de la sélection du profil, de la sélection du codec, du débit binaire ou du comportement de transport.

Comment déboguer ONVIF fonctionne mais RTSP échoue

Utilisez une liste de contrôle à plusieurs niveaux :

Vérifiez que le service RTSP de la caméra est activé.
Confirmez que le port RTSP, généralement 554, est accessible depuis le client.
Obtenez le profil multimédia ONVIF et diffusez l'URI.
Normalisez l'URL RTSP pour le chemin réseau que vous utilisez réellement.
Ajoutez soigneusement les informations d’identification et encodez les caractères spéciaux en URL.
Exécutez RTSP OPTIONS et DESCRIBE.
Inspectez les défis et les réponses d’authentification.
Inspectez SDP pour le codec, le type de charge utile, la fréquence d'horloge et les URL de contrôle de suivi.
Comparez le transport entrelacé UDP et TCP.
Confirmez que les paquets RTP arrivent après « PLAY ».
Vérifiez la continuité de la séquence RTP, les horodatages et le type de charge utile.
Testez le flux principal et le sous-flux séparément.

Cette liste de contrôle évite une erreur courante : considérer le succès de la découverte ONVIF comme une preuve que le streaming multimédia doit fonctionner automatiquement.

Ce que doit montrer la trace RTSP

Un flux RTSP sain ressemble généralement à :

OPTIONS rtsp://camera/stream RTSP/1.0
RTSP/1.0 200 OK

DESCRIBE rtsp://camera/stream RTSP/1.0
RTSP/1.0 200 OK
Content-Type: application/sdp

SETUP rtsp://camera/stream/trackID=1 RTSP/1.0
RTSP/1.0 200 OK
Transport: RTP/AVP/TCP;unicast;interleaved=0-1

PLAY rtsp://camera/stream RTSP/1.0
RTSP/1.0 200 OK

Final diagnosis

Preuve reproductible pour « ONVIF fonctionne mais l'URL RTSP échoue : recherche du véritable chemin du flux de la caméra »

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 « ONVIF fonctionne mais l'URL RTSP échoue : recherche du véritable chemin du flux de la caméra », 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 « ONVIF fonctionne mais l'URL RTSP échoue : recherche du véritable chemin du flux de la caméra », é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.