Description
Ce plugin permet de mettre à disposition du plugin Caméra une url vers une capture d’un flux RTSP.
Le pugin Caméra ne gère plus le protocol RTSP par soucis de stabilité et surtout de charge de votre Jeedom.
Le plugin RTSP vient palier se manque en proposant une alternative peu consommatrice de ressource mais avec un résultat dégradé. En effet, les captures sont réalisées toutes les ~2/3 secondes environ et stockées en mémoire pendant ~2/3 secondes.
Le plugin se base sur la commande ffmpeg fournie par la plupart des distributions GNU/Linux dont Debian sur laquelle repose Jeedom.
Ce plugin ne remplace en rien le plugin Camera, vous devez une fois le Flux RTSP créé, copier/coller l’URL de Capture dans un équipement Camera afin que celle-ci soit visible dans Jeedom.
Market
Ce plugin n’est pas présent sur le Market Jeedom mais sur le dépot NextDom
Forum
Lien vers le Forum
Configuration
Configuration du plugin
Après téléchargement du plugin, il vous faudra simplement activer le plugin :
Configuration des équipements
La configuration des équipements RTSP est accessible à partir du menu plugin :
Voilà à quoi ressemble la page du plugin RTSP (ici avec déjà 1 équipements) :
Comme à beaucoup d’endroits sur Jeedom, placer la souris tout à gauche permet de faire apparaître un menu d’accès rapide (vous pouvez, à partir de votre profil, le laisser toujours visible).
Une fois que vous cliquez sur l’un d’eux, vous obtenez :
Vous retrouvez ici toute la configuration de votre équipement :
- Nom de l’équipement RTSP : nom de votre flux RTSP,
- Objet parent : indique l’objet parent auquel appartient l’équipement,
- Catégorie : les catégories de l’équipement (il peut appartenir à plusieurs catégories),
- Activer : permet de rendre votre équipement actif
Vous retrouvez ici le paramètrage du flux RTSP de votre caméra :
- Adresse IP : ip de votre flux RTSP
- Port : port de votre flux RTSP, par exemple : 554
- Nom de la caméra : nom du service associé à la capture de votre flux RTSP
- Résolution : résolution de votre flux RTSP, par exemple : 1280x720
- Complément url (/chemin) : url du flux, par exemple : /ch1_0.h264
Vous retrouvez ici les paramètres optionnels du flux RTSP de votre caméra :
- Délai : délai entre 2 captures de votre flux RTSP
- Emplacement des captures : répertoire de sauvegarde de vos captures /tmp par défaut, il est conseillé de ne pas modifier cette option, sauf si /tmp n’est pas en ram (Voir la section dédiée plus bas)
- Nom d’utilisateur : utilisateur pour vous connecter à votre caméra (peut être vide)
- Mot de passe : mot de passe pour vous connecter à votre caméra (peut être vide)
Vous retrouvez ici le résultat du fichier à ajouter à votre équipement dans le plugin Camera :
- URL de capture (pour le plugin camera) : URL (en lecture seule) à fournir au plugin Camera, par exemple : snapshot_xiaoyi1.jpg :
Vous retrouvez ici la capture réalisée au moment où vous cliquez afin de tester votre configuration :
- Aperçu de la capture : Aperçu de la capture réalisée sur ce flux RTSP
- Rafraîchir : Action de rafraichissement de la capture de ce flux RTSP
- Status : Retour d’état du service RTSP pour ce flux
Caméras compatibles
Vous avez maintenant une documentation d’assistance sur l’équipement, cette documentation ouverte vous permettra de trouver l’url, le port ainsi que le protocole utilisé par votre caméra :
[NOTE]
Pour le moment Il n’y a aucune commande
FAQ
Est-ce que le plugin peut faire des captures plus régulière ?
Non, le plugin utilise une commande peu gourmande en ressource, pour celà une capture toute les 2 secondes environ est un bon compromis.
Pouquoi modifier l’emplacement des captures ?
Par défaut, les captures sont faites sur /tmp qui est monté en ram, ceci permet de ne pas user prématurément votre carteSD. Si ce n’est pas le cas chez vous (première Mini+ ou DIY). Voici un tutorial pour monter un dossier en RAM : Nous allons creer un point de montage sur /mnt/rtsp.
Il faut créer le dossier :
sudo mkdir /mnt/rtsp
Puis il faut changer les droits :
sudo chmod 777 /mnt/rtsp
Enfin un tmpfs se monte comme tous les points de montage sous linux,
avec la commande mount :
sudo mount -t tmpfs -o size=16M tmpfs /mnt/rtsp
Pour le monter automatiquement au démarrage il faut éditer le fichier /etc/fstab et rajouter :
Exemple de ligne à rajouter:
tmpfs /mnt/rtsp tmpfs defaults,size=16m 0 0
Enfin, n’oubliez pas de spécifier /mnt/rtsp dans le plugin RTSP !
Pourquoi le plugin est gratuit ?
Ce plugin est gratuit pour que chacun puisse en profiter simplement. Si vous souhaitez tout de même faire un don au développeur du plugin.
Je n’ai pas de capture d’écran
Vérifier si l’url http(s)://votrenomdedomaine/snapshot_test.jpg affiche une image. Si vous faites F5, celle-ci se raffraichit-elle ? Si oui Le problème vient du plugin Caméra. Sinon, exposez votre problème sur le forum.
Ma capture d’écran ne se raffraichit plus
Vérifier si l’url http(s)://votrenomdedomaine/snapshot_test.jpg affiche une image. Si vous faites F5, celle-ci se raffraichit-elle ? Si oui Le problème ne vient pas du plugin RTSP. Sinon, exposez votre problème sur le forum.
Ma capture d’écran ne se raffraichit toujours pas
Se connecter en SSH et vérifier les commandes suivantes : sudo service rtsp-service-{nomdevotreflusRTSP} status. Puis : sudo service rtsp-service-{nomdevotreflusRTSP} restart selon le résultat.
Idées pour de futures releases
Prochaine release
chapitre à garder seulement si une version développement est en cours
Changelog
Version 2.0.0: (2.0.0)
- Correction “DisplayException”
- Migration de la documentation vers GitHub
- Ajout de la licence en en-tête de chaque fichiers
- Correction concernant l’état du service lié à un équipement en fonction de son état
- Mise aux normes NextDom (Standard PSR, Icone, template de documentation, licence, readme, etc …)
- Ajout d’un changelog
Détail des changements
Détail complet des mises à jour sur Historique Commit
Bug
En cas de problèmes avec ce plugin il est possible d’ouvrir un ticket pour demander une correction :