SKOOR Documentation

Vidéo

Les vidéos peuvent être intégrées au tableau de bord ou dans l'en-tête du tableau de bord à l'aide du widget « Vidéos ».

Sources

Une vidéo provient soit d’un fichier mis en ligne, soit d’une URL externe. Les fichiers mis en ligne sont hébergés par le service web et accessibles via le chemin d’accès interne au fichier. Les URL externes sont transmises telles quelles ; elles doivent donc être accessibles au public depuis un navigateur.

Les fichiers vidéo directs (MP4, WebM) sont lus en natif dans le navigateur. Pour le format MP4, une vidéo H.264 avec audio AAC constitue le choix le plus sûr, car d’autres codecs tels que le H.265 ne sont pas pris en charge partout. La recherche dans un fichier nécessite que le server d’hébergement prenne en charge les requêtes HTTP de plage.

Flux en direct (HLS)

Les URL se terminant par .m3u8 sont reconnues comme des flux HLS et gérées par hls.js, qui est chargé à la demande. Cette fonctionnalité est prise en charge par les navigateurs actuels, y compris ceux qui ne prennent pas en charge nativement le protocole HLS. Sur les plateformes où hls.js ne peut pas s’exécuter, le widget utilise par défaut la lecture intégrée au navigateur.

Le server de diffusion doit envoyer des en-têtes CORS autorisant les requêtes GET, sinon le navigateur bloque la diffusion.

Les autres protocoles ne sont pas pris en charge. En particulier, les URL RTSP provenant de caméras IP ne peuvent être lues par aucun navigateur et doivent être converties au format HLS au préalable. Le protocole DASH (.mpd) n’est pas pris en charge non plus.

Restrictions

La taille des fichiers téléchargés est limitée à 100 Mo. Pour les vidéos plus volumineuses, utilisez plutôt une URL externe ou un flux. Si une vidéo ou un flux ne peut pas être chargé, le lecteur reste vide et n’affiche aucun message d’erreur ; il est donc recommandé de vérifier l’URL avant de publier un tableau de bord.

Modification des vidéos

Les propriétés suivantes peuvent être définies dans les paramètres du widget :

Paramètre	Description
Source	Choisissez si la vidéo provient d'un fichier téléchargé ou d'une URL externe. Les URL acceptent les fichiers vidéo directs (MP4, WebM) et les flux HLS (`.m3u8`).
Boucle	Relance automatiquement la vidéo lorsqu'elle arrive à la fin. N'a aucun effet sur les flux en direct.
Lecture automatique	Lance la lecture dès le chargement du widget. Les navigateurs n'autorisent cette fonctionnalité qu'en l'absence de son ; la lecture automatique force donc la mise en sourdine de la vidéo.
Sourdine	Lance la lecture de la vidéo sans son. Cette option reste activée lorsque la lecture automatique est activée.
Commandes	Affiche les commandes intégrées au lecteur du navigateur pour la lecture, la pause, le défilement, le volume et le plein écran. Sans elles, la vidéo ne peut être contrôlée qu’à l’aide des options de lecture automatique et de boucle.
Sous-titres	Sous-titres facultatifs affichés sous la vidéo.