Configuration: Actions

Les actions dans Agent DVR sont des réponses à des événements spécifiques, comme les alertes de caméra/IA ou les déconnexions de périphérique. Utilisez-les pour réagir automatiquement, par exemple en déclenchant une alarme, en allumant des lumières via l'URL d'une prise intelligente, ou en lançant l'enregistrement sur une autre caméra. Pour accéder et configurer les Actions, modifiez un périphérique et accédez à la section Actions dans le menu.

Cliquez sur « Ajouter » pour créer une nouvelle action. Un écran de configuration similaire aux images ci-dessous vous sera présenté :

Il existe un large éventail d'événements qui peuvent déclencher des actions. Plusieurs actions peuvent être associées à chaque événement, et vous pouvez incorporer diverses étiquettes dans ces actions pour créer des réponses dynamiques.

Configuration d'une action

• Actif : Activez ou désactivez cette option pour activer ou désactiver l'action. Vous pouvez également utiliser le Planning et l'API avec des commandes telles que actionOn, actionOff et actionRun, en utilisant l'ID affiché ci-dessus.
• Nom : Un nom optionnel pour l'action.
• Si : Sélectionnez un événement disponible (voir ci-dessous).
• Avec étiquette : (Événements IA). Ceci est principalement utilisé avec les événements IA. Par exemple, si vous sélectionnez IA : Objet trouvé et entrez chat ici, l'action ne se déclenchera que lorsqu'un chat est détecté. Notez que l'étiquette correspond en fonction de la langue sélectionnée dans Paramètres du serveur - Général.
• Règle : Choisissez si plusieurs étiquettes doivent toutes correspondre (ET) ou si l'une d'elles peut correspondre (OU).
• Dans les zones : (Événements IA). Spécifiez les zones de mouvement (à partir de l'onglet de détection de mouvement) pour filtrer les objets détectés. Par exemple, en sélectionnant la zone 1 et chat comme étiquette, l'action ne se déclenchera que lorsqu'un chat est détecté dans la zone 1. Laissez vide pour inclure toutes les zones.
• Délai d'expiration de répétition : Ceci supprime l'événement s'il a été déclenché dans cet intervalle et réinitialise également le minuteur. Par exemple, avec « Véhicule détecté » comme déclencheur et un délai d'expiration de 30 secondes, une alerte sera envoyée une fois, les alertes suivantes étant suspendues jusqu'à ce qu'il y ait une pause de 30 secondes dans le trafic détecté.
• Ajouter une tâche : Cliquez pour ajouter une tâche. Vous pouvez assigner plusieurs tâches à une action (v4.5.5.0+).

Les actions peuvent réagir à une large gamme d'événements système, d'appareil et d'IA. Les événements pour lesquels vous pouvez configurer des actions sont :

• Serveur IA hors ligne (le serveur IA a retourné une erreur - l'événement se déclenchera après 3 échecs de requête et ne se reproduira pas tant que le serveur n'est pas revenu en ligne)
• Serveur IA actif (le serveur IA a quitté l'état d'erreur)
• IA : Résultat positif Ask AI (Il a trouvé un objet que vous recherchiez)
• IA : Demander le résultat à l'IA (se déclenche sur toute réponse Ask AI, positive ou non)
• IA : Réponse de description reçue (Une image a été décrite par l'IA - la description se trouve dans les balises {MESSAGE} et {AIJSON})
• IA : Visage reconnu
• IA : Visage non reconnu
• IA : Plaque d'immatriculation reconnue
• IA : Plaque d'immatriculation non reconnue
• IA : Flânage détecté
• IA : Objet trouvé
• IA : Objet non trouvé
• IA : Son reconnu (micros uniquement)
• Alerte
• Alerte terminée
• Appel URL : réponse reçue - Cet événement est déclenché par la réponse que vous recevez lorsqu'une tâche « Appel URL » s'exécute, ce qui vous permet d'y répondre avec d'autres tâches.
• Alerte manuelle
• Mouvement détecté
• Fin du mouvement
• Aucun - utilisez cette option si vous souhaitez déclencher l'action vous-même avec la commande « Action : Exécuter » sur l'agenda
• Événement ONVIF activé - utilisez cette option pour par exemple démarrer et arrêter l'enregistrement en fonction des mises à jour d'état logique ONVIF (nécessite que le type de détecteur de mouvement soit défini sur ONVIF)
• Événement ONVIF désactivé
• Événement ONVIF reçu (se déclenche sur tout événement ONVIF de la caméra)
• Photo prise
• Préréglage PTZ appliqué
• Échec de la reconnexion
• Échec de l'enregistrement
• Enregistrement terminé
• Enregistrement commencé
• Source déconnectée
• Source reconnectée
• Source masquée/sabotée
• Éteindre l'appareil
• Allumer l'appareil
• Système : Armé
• Système : Désarmé
• Système : Aucune UI connectée - lorsque la dernière session d'interface se ferme
• Système : Profil appliqué
• Système : Interface connectée - lorsque quelqu'un ouvre un navigateur pour afficher votre système
• Système : Interface déconnectée - lorsque la session est fermée (se produit environ une minute après la déconnexion du navigateur)
• Timelapse démarré
• Timelapse arrêté

Tous les événements de plugin et les tâches personnalisées que vous avez ajoutés apparaissent également à la fin de cette liste.

Pour détecter le flânage (des personnes ou des objets restant au même endroit pendant une certaine période) vous devez configurer les éléments suivants :

• Configurez un serveur IA dans les paramètres du serveur
• Ajoutez une action pour IA : Flânage détecté
• Définissez l'étiquette que vous recherchez - ce serait généralement personne mais vous pourriez utiliser voiture pour détecter les voitures garées dans une zone trop longtemps ou valise pour les bagages oubliés ou un chat assis sur votre canapé. Vous pouvez utiliser plusieurs étiquettes ici par exemple voiture,bus,camion. Pour une liste des objets disponibles à rechercher, consultez la liste des classes dans la reconnaissance d'objets lorsque vous modifiez la caméra.
• Spécifiez les zones dans lesquelles vous souhaitez rechercher l'objet. Utilisez l'onglet détecteur pour tracer les zones de mouvement.
• Spécifiez le nombre de secondes pendant lequel vous tolèrerez que l'objet détecté se trouve dans la zone.
• Ajoutez des tâches à effectuer lorsque les conditions sont remplies.

Remarque : Le détecteur de flânage utilise les paramètres de la reconnaissance d'objets comme la vérification des coins et la superposition

Au-delà des événements prédéfinis, vous pouvez créer des événements personnalisés en ajoutant des Tâches. Une fois qu'une tâche est créée, elle apparaîtra dans la liste des Événements. Vous pouvez ensuite configurer une Action pour répondre à cette tâche. Les tâches peuvent être déclenchées à partir de la page EN DIRECT dans l'interface utilisateur (en sélectionnant une caméra puis en cliquant sur l'icône de la tâche en bas à gauche) ou par la commande Action : EXÉCUTER disponible dans le Planning.

Les Tâches sont des commandes que vous pouvez associer aux périphériques pour déclencher manuellement les actions. Les actions peuvent appeler des API tierces pour effectuer des tâches telles que l'ouverture de portes, l'activation d'éclairages, la lecture de sons, etc. Pour ajouter, supprimer et exécuter des tâches, sélectionnez un périphérique sur la page EN DIRECT et cliquez sur l'icône de tâche .

Configuration d'une tâche :

• Entrez du texte pour décrire la tâche, par exemple « Activer les lumières » et cliquez sur le bouton +. Cliquez sur OK
• Cliquez pour modifier le périphérique à l'aide de l'icône de modification . Sélectionnez le panneau Actions dans l'éditeur à l'aide du menu en haut à droite.
• Ajoutez une action. Sélectionnez la condition « Si » comme étant la tâche que vous venez de créer (les tâches sont affichées au bas de la liste des actions disponibles) puis configurez ce que vous souhaitez que la tâche fasse.
• Cliquez sur OK
• Vous pouvez maintenant déclencher manuellement cette action à partir de la vue en direct en cliquant sur le bouton Tâches et en cliquant sur le bouton flèche Aller à côté de la tâche.

Vous pouvez également déclencher les tâches via l'API Agent DVR.

Les tâches sont les actions que réalise une règle lorsque son événement se déclenche, qu'il s'agisse d'envoyer une alerte par e-mail ou une notification push jusqu'au contrôle de l'enregistrement sur d'autres appareils. La liste des tâches disponibles que vous pouvez effectuer (sous Ensuite) est :

• Alerte - déclenche une alerte sur l'appareil
• Bip - joue un bip via le haut-parleur de l'ordinateur Agent DVR
• Appeler une URL - appelez une URL avec un jeton d'authentification optionnel. Vous pouvez appeler l'API Agent DVR ici, ou envoyer des alertes à Discord, Slack, ntfy et services similaires (voir Webhooks). Si vous avez coché Protect API dans les paramètres du serveur, vous devrez fournir un en-tête d'autorisation. Pour ce faire, vous devrez ajouter un Compte utilisateur via les paramètres du serveur et entrer une valeur d'En-tête d'autorisation :
  Générer

• Exécuter une commande

copy %1 D:\

• Envoi Cloud de l'enregistrement actuel - téléchargez l'enregistrement actuel vers le fournisseur cloud de l'appareil
• Délai - pause avant d'exécuter la tâche suivante
• Désactiver Ask AI
• Désactiver la reconnaissance faciale
• Activer/Désactiver LPR
• Désactiver la reconnaissance d'objets
• Désactiver la patrouille sur (patrouille PTZ sur un appareil)
• Désactiver la reconnaissance sonore
• Envoi FTP de l'enregistrement actuel - téléchargez l'enregistrement actuel vers le serveur FTP de l'appareil
• Journal - écrivez un message dans le journal Agent DVR
• MQTT - envoyez un message MQTT
• Image MQTT - envoyez une image en direct brute en octets jpeg à un sujet
• Message réseau
• Commande PTZ - déplacez la caméra vers un préréglage ou exécutez une commande PTZ
• Envoyer un e-mail (avec pièces jointes image optionnelles)
• Envoyer un e-mail avec la vidéo (spécifiez la durée - cela inclut une mémoire tampon de l'événement). v4.9.8.0+
• Envoyer une notification push
• Envoyer un SMS
• Définir la zone de détection de mouvement (sélectionnez la zone que vous avez définie sur le Détecteur)
• Afficher le message - affiche un message sur les navigateurs web en consultation
• Son (via le navigateur web)
• Son (via la caméra)
• Son (via le navigateur web)

• Démarrer l'enregistrement sur (un certain appareil) - enregistrera jusqu'à arrêt.
• Démarrer le streaming RTMP
• Démarrer le timelapse sur (un certain appareil)
• Arrêter l'enregistrement sur (un certain appareil)
• Arrêter le streaming RTMP
• Arrêter le timelapse sur (un certain appareil)
• Allumer l'appareil
• Éteindre l'appareil
• Système : appliquer le profil - changez de Profil
• Système : Armer
• Système : désarmer
• Étiqueter l'enregistrement - ajoutez une étiquette à l'enregistrement actuel
• Prendre une photo lors de (un certain appareil)
• Synthèse vocale (sur l'ordinateur Agent DVR - nécessite un compte iSpyConnect.com car le texte est rendu via des appels de service web)
• Synthèse vocale (via le navigateur web)

• Synthèse vocale (via la caméra)
• Activer l'encodage adaptatif lors du déclenchement (un autre appareil)
• Déclencher une alerte lors de (un autre appareil)
• Déclencher Ask AI (un autre appareil)
• Déclencher la reconnaissance audio (un autre appareil)
• Déclencher la détection lors de (autre périphérique)
• Déclencher la reconnaissance faciale (autre périphérique)
• Déclencher la LPR (autre périphérique)
• Déclencher la reconnaissance d'objets (autre périphérique)
• Déclencher l'enregistrement (avec délai) (autre périphérique). Cela enregistrera jusqu'au paramètre de délai d'enregistrement déclenché dans l'onglet Enregistrement. Ce délai se réinitialise à chaque appel d'action d'enregistrement déclenché.
• Interface : Changer la vue - basculer les interfaces connectées vers une vue différente

Les balises dans les champs Ensuite des actions Agent DVR vous permettent de créer des réponses dynamiques. Il est important de noter que certaines balises sont spécifiques au contexte. Par exemple, {FILENAME} n'est pas disponible pour les événements d'alerte, et {AI} n'est pas disponible si l'événement n'a pas été généré par un serveur IA.

• {ID} : L'ID de l'objet, visible en haut à gauche de l'éditeur lors de la modification d'une caméra ou d'un microphone dans Agent.
• {OT} : L'ID du type d'objet. 1 pour Microphone, 2 pour Caméra.
• {FILENAME} : Le nom du fichier. S'applique aux événements tels que Enregistrement commencé, Enregistrement terminé et Instantané pris. C'est le chemin d'accès local complet au fichier.
• {CURRENT_RECORDING} : Le nom du fichier de l'enregistrement actuel. Chemin d'accès local complet au fichier. (v5.0.6.0+)
• {MESSAGE} : Le nom de l'événement qui a déclenché l'action, par exemple « Alerte manuelle ».
• {EVENT} : Le type d'événement.
• {NAME} : Le nom du périphérique (présent dans l'onglet Général).
• {GROUPS} : Les groupes auxquels le périphérique appartient (présents dans l'onglet Général).
• {SERVER} : Le nom du serveur (à partir des Paramètres du serveur).
• {ALERTID} : L'ID de l'alerte (-1 s'il n'y a pas d'alerte associée).
• {ALERTCOUNT} : Le nombre d'alertes du périphérique.
• {TIME} et {DATE} : L'heure et la date actuelles sur le serveur.
• {RECORDED} : « REC » si le périphérique est en cours d'enregistrement, sinon vide.
• {TAGS} : Les balises associées à l'événement.
• {PLUGIN} : Le message d'un événement de plugin.

• {LOCATION} : L'emplacement de la caméra (présent dans l'onglet Général).
• {LEVEL} et {DB} : Le niveau de mouvement ou audio. {DB} est le niveau en décibels pour les périphériques audio. Mesuré lors de l'exécution de l'action. (v4.3.7.0+)
• {AI} : Une liste séparée par des virgules des objets détectés à partir de l'IA, des plaques de LPR, ou des visages détectés à partir de la reconnaissance faciale.
• {AIJSON} : Données JSON renvoyées par l'IA ou LPR.
• {ZONE} : La zone qui a déclenché l'action (vide si vous n'utilisez pas l'IA ou une liste CSV pour plusieurs zones comme 1,2,3).
• {BASE64IMAGE} : URL des données d'image en direct. Ce sont les octets bruts codés en base64, donc formatez-les selon vos besoins, par exemple,

  p=data:image/jpeg;base64,{BASE64IMAGE}

  (Disponible v4.5.9.0+). Image en direct redimensionnée à 640 px de largeur.
• {BASE64IMAGE-LG} : URL des données d'image en direct. Ce sont les octets bruts codés en base64, donc formatez-les selon vos besoins, par exemple,

  p=data:image/jpeg;base64,{BASE64IMAGE-LG}

  (Disponible v6.0.8.0+). Image en direct redimensionnée à 1280 px de largeur.
• {BASE64IMAGE-NATIVE} : URL des données d'image en direct. Ce sont les octets bruts codés en base64, donc formatez-les selon vos besoins, par exemple,

  p=data:image/jpeg;base64,{BASE64IMAGE-NATIVE}

  (Disponible v6.0.8.0+). Image en direct native.
• {TRIPCOUNT}, {TRIPCOUNTLEFT} et {TRIPCOUNTRIGHT} : Les compteurs de franchissement de fil de détection (total, gauche et droite) additionnés sur tous les fils de détection de la caméra. 0 si la caméra n'utilise pas le détecteur de fil de détection. (v7.7.4.0+)
• {TRIPJSON} : Les compteurs de fil de détection au format JSON avec une ventilation par fil, par exemple

  {"left":3,"right":2,"total":5,"wires":[{"wire":1,"left":3,"right":2,"total":5}]}

  (v7.7.4.0+)

Par exemple, avec un événement IA : Visage reconnu, une tâche Ensuite Synthèse vocale avec le texte

Bonjour {AI}

Remarque : Si vous utilisez des balises {BASE64IMAGE} avec un événement lié à un fichier comme « Photo prise », elle utilisera l'image de taille complète du fichier. Sinon, elle redimensionnera l'image de la vue en direct actuelle.

Une fois qu'une action est ajoutée, le contrôle du tableau affiche un résumé de vos actions. Une coche verte indique une action active.

Vous pouvez utiliser le planificateur pour activer/désactiver les actions ou déclencher une action. Par exemple, vous pouvez planifier une action pour envoyer un email avec deux images à une heure spécifique.

Dans cet exemple, une action a été ajoutée pour envoyer un email avec 2 images, définie sur aucun événement. Ensuite, une entrée du planning a été créée pour exécuter cette action à 8h le dimanche et le samedi.