Plugin Caméra

Description

Plugin permettant de créer et gérer des caméras wifi (affichage et enregistrement).

Configuration du plugin

Après installation du plugin, il vous suffit de l’activer. Quelques paramètres sont à renseigner dans la configuration du plugin :

• Chemin des enregistrements : indique le chemin où Jeedom doit stocker les images qu’il capture de vos caméras (il est déconseillé d’y toucher). Si votre chemin n’est pas dans le chemin d’installation de Jeedom alors vous ne pourrez visualiser les captures dans Jeedom.
• Taille maximum du dossier d’enregistrement (Mo) : indique la taille maximum autorisée pour le dossier où les captures sont enregistrées (il est déconseillé d’y toucher). Si ce quotas est atteint Jeedom supprimera les captures les plus anciennes.
• Le plugin caméra doit réagir aux interactions : mots clés / phrases auxquel(le)s le plugin réagira via les interactions de Jeedom.
• Panel : permet d’afficher le panel (Menu Accueil → Caméra) et d’avoir une vue sur l’ensemble de vos caméras (voir plus bas). N’oubliez pas d’activer le panel dans la configuration du plugin pour y avoir accès plus tard.

Compatibilité

Vous pouvez trouver ici la liste des modules compatible avec le plugin

Configuration des équipements

Equipement

Ici vous avez les informations principales de votre caméra :

• Nom de l’équipement caméra : nom de votre équipement caméra.
• Objet parent : indique l’objet parent auquel appartient l’équipement.
• Activer : permet de rendre votre équipement actif.
• Visible : le rend visible sur le dashboard.
• IP : l’adresse IP local de votre caméra.
• Port : le port pour sur lequel joindre la caméra.
• Protocole : le protocole de communication de votre caméra (http ou https).
• Nom d’utilisateur : nom d’utilisateur pour se connecter à la caméra (si nécessaire). Attention le plugin ne supporte pas les caractères spéciaux (il faut donc se limiter aux chiffres, lettres minuscule/majuscule).
• Mot de passe : mot de passe pour se connecter à la caméra (si nécessaire).Attention le plugin fait un url_encode pour le nom d’utilisateur et mot de passe obligatoire pour certaine camera mais cela peut poser soucis pour d’autre, si vous avez un soucis essayez sans caractères spéciaux (se limiter aux chiffres, lettres minuscule/majuscule).
• URL de snapshot : chemin de l’URL de “snapshot” de la caméra de type /cgi-bin/CGIProxy.fcgi?cmd=snapPicture2&usr=#username#&pwd=#password# (exemple pour les caméras Foscam). Change en fonction des caméras. Attention à ne pas mettre une url de flux sous peine de planter Jeedom. Vous pouvez ajouter les tags #username# et #password#, qui seront respectivement remplacés par le contenu du champ Nom d'utilisateur et du champ Mot de passe lors de l’utilisation de cette commande. (Attention, ne pas indiquer l’URL complète ! Uniquement le chemin commencant par /).
• URL du flux : URL complète du flux video de la caméra de type rtsp://#username#:#password#@#ip#:554/videoMain (exemple pour les caméras Foscam). Vous pouvez ajouter les tags #ip#, #username# et #password#, qui seront respectivement remplacés par le contenu du champ IP, du champ Nom d'utilisateur et du champ Mot de passe lors de l’utilisation de cette commande. Si l’URL de snapshot n’est pas remplie, une image sera capturée dans ce flux video à chaque délai de rafraichissement.
• Stream du flux RTSP : si vous etês en mode flux video (URL du flux remplie) alors vous pouvez voir la camera sous forme de flux video au lieu d’image par image. Attention cette option est très consommatrice de ressources et rend la 1er image très longue à arriver.
• Previsualiser : permet de voir si jeedom recupere bien le flux video (Sauvegarder avant de test pour voir si vos modifications marchent)
• Option flux video : si vous etês en mode flux video (URL du flux remplie et URL de snapshot vide) alors vous pouvez passer des parametres supplémentaire ici à ffmpeg et avconv (reservé aux experts)
• Modèle : permet de choisir le modèle de la caméra. Attention : si vous changez cela écrasera vos paramètres de configuration.

Les paramètres ONVIF :

• Port ONVIF : le port servant pour onvif
• Jeton de profil : jeton servant à lancer les commandes par onvif
• Vitesses X, Y et Z : vitesse de mouvement ptz (entre 0 à 1)
• Délai avant commande stop (en ms) : délai avant commande de stop ptz
  • Il faut renseigner la commande de Stop sur chaque commande de mouvement PTZ dans le champ prévu à cet effet

NOTE

Vous pouvez retrouver ici des configuration pour pas mal de camera et donc pouvoir integrer votre camera vous meme à Jeedom si elle n’est pas dans la liste

Image

Cette partie vous permet de configurer la qualité de l’image. En effet Jeedom diminue la taille de l’image ou la compresse avant de l’envoyer à votre navigateur. Cela permet de gagner en fluidité des images (car elles sont moins lourdes). C’est aussi dans cette partie que vous pouvez configurer le nombre d’images par seconde à afficher. Tous les réglages sont déclinés en : mobile/desktop et miniature/normal.

• Rafraichissement (s) : délai en seconde entre l’affichage de 2 images (vous pouvez ici mettre des chiffres inférieurs à 1).
• Compression (%) : plus il est faible moins on compresse l’image, à 100 % aucune compression n’est faite.
• Taille (% - 0 : automatique) : plus le % est élévé plus on est proche de la taille d’origine de l’image. A 100 % aucun redimensionnement de l’image n’a lieu.

NOTE

Si vous mettez une compression de 0% et une taille de 100%, Jeedom ne touchera pas à l’image en mode normal. Cela n’est pas valable en mode miniature où il y a une taille maximum de l’image de 360px.

Capture

• Durée maximum d’un enregistrement : durée maximum des enregistrements.
• Toujours faire une vidéo : force Jeedom à toujours transformer les enregistrements en vidéo avant l’enregistrement.
• Nombre d’images par seconde de la vidéo : nombre d’images par seconde des vidéos.
• Supprimer toutes les captures de la caméra : supprime toutes les captures et enregistrements de la caméra.

Alimentation

• Commande ON : Commande permettant de mettre en marche l’alimentation de la caméra.
• Commande OFF : Commande permettant de couper l’alimentation de la caméra.

Commandes

• ID de la commande (utiliser avec les commandes de type info pour par exemple remonter l’information de mouvement de la caméra à Jeedom par l’api, voir plus bas)
• Nom de la commande avec la possibilité de mettre une icône à la place (pour la supprimer il faut double-cliquer sur l’icône en question)
• Type et sous-type de la commande
• Requête à envoyer à la caméra pour faire une action (passage en mode nuit, ptz, etc.). Vous pouvez utiliser les tags #username# et #password#, qui seront automatiquement remplacés par le nom d’utilisateur et le mot de passe lors de l’utilisation de cette commande
• Commande stop : pour les caméras PTZ, il existe souvent une commande qui arrête le mouvement, c’est ici qu’il faut la spécifier
• Afficher : permet d’afficher la commande ou non sur le dashboard
• Configuration avancée (petites roues crantées) : permet d’afficher la configuration avancée de la commande (méthode d’historisation, widget, etc.)
• Tester : permet de tester la commande
• Supprimer (signe -) : permet de supprimer la commande

Le widget

On retrouve sur celui-ci l’image de la caméra, les commandes définies dans la configuration, la commande pour prendre une capture, la commande pour lancer la prise de multiples captures images et la commande pour parcourir ces captures.

ASTUCE

Sur le dashboard et le panel il est possible de redimensionner le widget pour l’adapter à ses besoins.

Un clic sur l’image permet d’afficher celle-ci dans une fenêtre et dans un format plus grand.

Un clic sur la dernière commande pour parcourir les captures vous affichera celles-ci.

Vous retrouvez ici toutes les captures organisées par jour puis par date, vous pouvez pour chacune d’elle :

• la voir en plus en grand en cliquant sur l’image
• la télécharger
• la supprimer

En mobile le widget est un peu différent : si vous cliquez sur l’image de la caméra vous obtenez celle-ci en plus grande avec les commandes possibles.

Les panels

Le plugin caméra met aussi à disposition un panel qui vous permet de voir d’un seul coup toutes vos caméras, il est accessible par Acceuil → Caméra.

NOTE

Pour l’avoir il faut l’activer sur la page de configuration du plugin.

Il est bien sur aussi disponible en mobile par Plugin → Caméra.

Enregistrement et envoi de capture

Cette commande, un peu spécifique, permet suite à la prise de capture de faire l’envoi de celle-ci (compatible avec le plugin slack, mail et transfert).

La configuration est assez simple vous appelez l’action d’envoi de capture (dénommée “Enregistrement”) dans un scénario. Dans la partie titre vous passez les options.

Par défaut il suffit de mettre le nombre de captures voulues dans le champ “nombre captures ou options”, mais vous pouvez aller plus loin avec des options (voir détail ci-dessous “options avancées des captures”). Dans la partie message, vous n’avez plus qu’à renseigner la commande du plugin (actuellement slack, mail ou transfert) qui fait l’envoi des captures. Vous pouvez en mettre plusieurs séparés par des &&.

Options avancées des captures

• nbSnap : nombre de capture, si non précisé alors les captures sont faites jusqu’à une demande d’arrêt d’enregistrement ou d’arrêt de la caméra
• delay : délai entre 2 captures, si non précisé alors le délai est de 1s
• wait : délai d’attente avant de commencer les captures, si non précié alors aucun envoi n’est fait
• sendPacket : nombre de captures déclenchant l’envoi de paquet de captures, si non précisé alors les captures ne seront envoyées qu’à la fin
• movie=1 : une fois l’enregistrement terminé, les images sont converties en vidéo
• sendFirstSnap=1 : envoi la première capture de l’enregistrement

Exemples

nbSnap=3 delay=5 ==> envoi 3 captures faites à 5 secondes d’intervalle (envoi déclenché via le scénario)

movie=1 sendFirstSnap=1 ==> enregistre une vidéo jusqu’à la commande “Arrêter Enregistrement” à insérer dans le scénario. Le film sera stocké sur votre Jeedom.

Envoi de la détection de mouvement à Jeedom

Si vous avez une caméra qui possède la détection de mouvement et que vous voulez transmettre celle-ci à Jeedom voilà l’url à mettre sur votre caméra :

https://#IP_JEEDOM#/core/api/jeeApi.php?apikey=#APIKEY_CAMERA#&plugin=camera&type=event&id=#CMD_ID#&value=#VALUE#

Il faut bien entendu avant avoir créé une commande de type info sur votre caméra

FAQ

Où sont les enregistrements ?

Les enregistrements se trouvent par défaut dans plugins/camera/data/records/ID_CAM, attention cela peut varier si vous avez demandé à Jeedom de les enregistrer ailleurs.

Les dépendances n’arrivent pas à s’installer ?

En ssh ou dans Administration -> OS/DB -> Système faire : dpkg --configure -a.

Quelles sont les conditions pour que ma caméra soit compatible Jeedom (si elle n’est pas dans la liste de compatibilité) ?

La seule condition c’est que la caméra possède une url qui renvoi une image (et bien une image pas un flux video).