Gérer la lecture de vidéos

Les commandes de lecture sont conformes aux normes RTSP et à la spécification de diffusion ONVIF (https://www.onvif.org/profiles/specifications/).

Résumé de l’enregistrement

Vous pouvez obtenir un aperçu de tous les enregistrements vidéo disponibles sur le périphérique à l’aide de la commande GetRecordingSummary. Cela n’est pas nécessaire, mais cela permet d’avoir des informations utiles avant d’effectuer une recherche.

Vous pouvez utiliser GetRecordingSummary et/ou GetMediaAttributes pour obtenir l’horodatage du premier et du dernier enregistrement, mais vous devez d’abord activer le paramètre Utiliser les configurations des caméras sur le plug-in Milestone Open Network Bridge dans le XProtect Management Client.

Créer un proxy pour le service RecordingSearch à l’aide du point de terminaison de service renvoyé par GetServices. Créer des objets de demande et de réponse, puis appeler GetRecordingSummary.

Recherche d’enregistrement

La méthode Service de recherche FindRecordings lance une recherche asynchrone sur la caméra. FindRecordings retourne un jeton qui référence les résultats de la recherche. Même s’il n’y a qu’un enregistrement disponible, une recherche est le moyen approprié pour obtenir une référence de l’enregistrement concerné.

Envoyez une requête FindRecordings avec les paramètres obligatoires suivants :

• SearchScope > IncludedSources > Token – vous devez fournir le jeton de la caméra GUID
• SearchScope > RecordingInformationFilter – schaîne avec les paramètres suivants :
  • timestamp (au format UTC)
  • maxTimeBefore (l’heure avant l’estampille temporelle demandée, en millisecondes)
  • maxCountBefore (le nombre maximum de pistes avant l’estampille temporelle demandée)
  • maxTimeAfter (L’heure après l’estampille temporelle demandée, en millisecondes)
  • maxCountAfter (le nombre maximum de pistes après l’estampille temporelle demandée)

Par exemple :

boolean(//Track[TrackType = “Video”]),2016-12-06T08:07:43Z,99999999,20,99999999,20

Vous recevrez une réponse avec SearchToken, qui est unique pour les critères de recherche.

Transmettez le SearchToken à GetRecordingSearchResults pour obtenir une liste comportant toutes les pistes correspondant aux critères de recherche.

Lancement de la lecture

Lors de la lecture de vidéos, la vitesse par défaut est 1 (lecture normale en direction avant).

La lecture est lancée au moyen de la méthode RTSP PLAY. Il est possible de spécifier une plage. Si aucune plage n’est spécifiée, le flux est diffusé à partir du début et jusqu’à la fin ou, s’il est mis en pause, il reprend à l’endroit où il s’était arrêté. Dans cet exemple, Range: npt=3-20 demande au serveur RTSP de commencer la lecture à la troisième seconde et de s’arrêter à la 20e seconde.

Par exemple :

Lecture arrière

Les périphériques ONVIF peuvent prendre en charge la lecture arrière. La lecture arrière est indiquée par un champ « Échelle » doté d’une valeur négative dans l’en-tête. Par exemple, pour lire un fichier en arrière sans perdre de données, une valeur de -1,0 sera utilisée.

Le Milestone Open Network Bridge prend en charge des valeurs comprises entre [-32 : 32].

Changement de vitesse

La vitesse est contrôlée par l’en-tête RTSP Rate-Control. Si Rate-Control=yes, le serveur contrôle la vitesse de lecture. Le flux est diffusé en temps réel à l’aide des mécanismes temporels RTP standard. Si Rate-Control=no, le client contrôle la vitesse de lecture. La lecture à débit contrôlé est généralement utilisée uniquement par les clients spécifiques non-ONVIF, car ils n’ont pas spécifié Rate-Control=no.

Pour contrôler la vitesse de lecture dans un client, utilisez les commandes fournies. Par exemple, avec le lecteur multimédia VLC, sélectionnez Lecture > Vitesse > Plus vite ou Moins vite. Ceci augmente ou réduit la vitesse de 0,5.

Plus vite (fin) et Moins vite (fin) change la vitesse de 0,25.

Gérer la lecture sur le lecture multimédia VLC en saisissant des lignes de commande

Vous pouvez gérer la lecture de vidéos sur le lecteur multimédia VLC en utilisant des lignes de commande. Veuillez vous reporter à l’aide sur les lignes de commande VLC (https://wiki.videolan.org/VLC_command-line_help/) pour plus de détails.

Ces commandes vous permettent, par exemple, de lire un fichier à l’envers et de changer le point de début de la lecture.

Voici un exemple d’une ligne de commande typique :

>vlc.exe --rate=-1.0 --start-time=3600 "rtsp://user:1234@test01:554/vod/943ffaad-42be-4584-bc2c-c8238ed96373"

Où :

• Le débit est le paramètre d’échelle et de vitesse
• Start-time (l’horaire de début) est exprimé en secondes après le début sur la base de données

Voici les commandes de lecture pour le lecteur multimédia VLC :

Code	Objectif	Valeurs	Utilisation
input-repeat=	Répétition des entrées	<entier [-2147483648 .. 2147483647]>	Nombre de répétitions de la même entrée
start-time=	Début Temps	<float>	Le flux démarrera à cette position (en secondes).
stop-time=	Heure d’arrêt	<float>	Le flux s’arrêtera à cette position (en secondes).
run-time=	Durée d’exécution	<float>	Le flux sera diffusé sur cette durée (en secondes).
input-fast-seek no-input-fast-seek	Recherche rapide (désactivée par défaut)		Accorde la priorité à la vitesse plutôt qu’à la précision pendant la recherche.
rate=	Vitesse de lecture	<float>	Ceci définit la vitesse de lecture (vitesse nominale de 1,0).
input-list=	Liste d’entrées	<string>	Vous pouvez fournir une liste d’entrées séparées par des virgules, qui seront concaténées après l’entrée normale.
input-slave=	Esclave d’entrée (expérimental)	<string>	Ceci vous permet de diffuser à partir de plusieurs entrées en même temps. Cette fonction est expérimentale et certains formats ne sont pas pris en charge. Utilisez une liste d’entrées séparées par un « # ».

Récupérer des enregistrements d’une plage de temps précise

Vous pouvez requérir la lecture vidéo pour un moment spécifique en utilisant le paramètre facultatif d’URL clock dans un lien RTSP.

Le format est alors le suivant : rtsp://[hostname]:[port]/vod/[camera_guid]?clock=[start_time]-[end_time]Z.

Les propriétés [start_time] et [end_time] suivent généralement le format yyyyMMddTHHmmssZ (année, mois, jour, lettre fixe T, heure au format 24 h, minutes, secondes et lettre fixe Z).

La propriété end_time est facultative. Pour indiquer uniquement l’heure de début, utilisez le format suivant : rtsp://[hostname]:[port]/vod/[camera_guid]?clock=[start_time]-. Par exemple, rtsp://onbhost:554/vod/3bf3b583-768a-43c7-ae74-38df708c4dbf?clock=20250830T140000Z- récupérera un flux qui commence à 14:00 UTC, le 30 août 2025.

La lettre Z indique le fuseau horaire UTC. Même en cas d’omission (à éviter), l’heure est toujours considérée en UTC, sauf indication contraire. Pour définir un fuseau horaire, utilisez l’un des suffix pris en charge :

• La lettre fixe p ou +, suivie par hhmm, indique un décalage UTC positif. Par exemple, 20250830T140000p0100 correspond à UTC+01:00 (heure d’Europe centrale).

• La lettre fixe m, suivie par hhmm, indique un décalage UTC négatif. Par exemple, 20250830T140000m0800 correspond à UTC-08:00 (heure du Pacifique).