Agent DVR: Plugins

Installer des plugins

Les plugins sont des modules complémentaires optionnels qui étendent Agent DVR avec des fonctionnalités supplémentaires de traitement audio et vidéo, comme la lecture de codes-barres, les superpositions météorologiques et les filtres audio.

Le moyen le plus facile d'installer les plugins est via le portail web distant. Une fois connecté, cliquez sur l'icône Serveur en haut à droite et accédez à « Plugins » sous Système. Ici, vous pouvez sélectionner le plugin que vous souhaitez utiliser dans le menu déroulant en haut à droite et cliquer sur « Installer » pour commencer.

Préférez installer manuellement ? Pas de problème ! Vous pouvez construire les plugins à partir de la source puis copier la sortie construite vers Agent/Plugins/PLUGINNAME. Cette méthode vous donne plus de contrôle sur le processus d'installation.

Plugins disponibles

Agent DVR est fourni avec des fonctionnalités avancées de traitement vidéo comme l'intégration CodeProject AI, ainsi que le suivi avancé d'objets, la reconnaissance audio et les détecteurs de comptage. Pour améliorer davantage votre expérience, nous proposons une gamme de plugins que vous pouvez utiliser dans AgentDVR pour étendre ses fonctionnalités.

Liste des plugins

Codes-barres

Scannez pratiquement n'importe quel code-barres depuis une caméra (Windows uniquement).

Événements levés : Code-barres reconnu
Supports : Vidéo

capture d'écran

Gain

Appliquez des filtres de bande en direct sur l'audio provenant de dispositifs audio.

Événements levés : Aucun
Supports : Audio

capture d'écran

Délai en direct

Ajoute un délai à l'audio et à la vidéo en direct (utile pour l'analyse sportive).

Événements levés : Aucun
Supports : Vidéo, Audio

capture d'écran

Météo

Ajoute une superposition d'état météorologique à la vidéo en direct en fonction de votre localisation. Levez des événements si la météo change - par exemple si un orage approche ou si les rafales de vent ou les limites de température sont dépassées. Vous pouvez personnaliser la mise en page et le mode d'affichage des données météorologiques, d'une simple icône à un détail complet.

La configuration météo utilise une chaîne de format pour organiser les informations. Voici quelques exemples de chaînes de format que vous pouvez utiliser :

Informations complètes :

{icon}{main}: {description} 
 Vent : {wind} Rafales : {gust} 
 Temp : {temp} Ressenti : {feelsLike} 
 Humidité : {humidity} IUV : {uvi}

Icône uniquement :

{icon}

Une ligne :

{main} {wind} {temp} {humidity} IUV : {uvi}

Événements levés : Température élevée, Rafales, État
Supports : Vidéo

capture d'écran
Si vous utilisez un plugin audio comme Listen sur une caméra, vous devrez modifier la caméra, sélectionner l'onglet Audio et cliquer pour configurer le microphone. À partir de là, vous pouvez accéder à l'onglet Plugins pour les dispositifs audio. Vous pouvez également cliquer sur l'icône Serveur, Modifier les dispositifs et modifier le microphone à partir de cette liste.

Configuration des plugins

Prêt à exploiter la puissance des plugins ? Il vous suffit d'ajouter un appareil (caméra et/ou microphone) et d'accéder à ses paramètres d'édition. Recherchez l'onglet Plugins dans la liste déroulante en haut à droite. Ici, vous pouvez sélectionner le plugin souhaité et cliquer sur le bouton « ... » pour le configurer selon vos besoins.

Certains plugins déclenchent des événements auxquels vous pouvez attacher des actions. Le plugin Weather, par exemple, déclenche un événement Gust lorsque les rafales de vent dépassent une valeur spécifiée (configurable dans le plugin). En éditant la caméra et en accédant à l'onglet Actions, vous avez la possibilité de répondre à cela - déclencher une alarme ou démarrer un enregistrement par exemple. Il vous suffit de sélectionner le nom du plugin : événement (par ex. Weather: Gust) dans la zone If et d'assigner une action.

Créez votre propre plugin

Les plugins sont des modules dynamiques que vous pouvez ajouter à Agent DVR pour améliorer ses capacités de traitement audio et vidéo. Avec les plugins, appliquez des effets en temps réel, des superpositions, déclenchez des événements et des alertes dans Agent DVR, permettant des actions personnalisées avancées.

Pour commencer à créer des plugins pour Agent DVR, commencez par cloner nos plugins open-source à https://github.com/ispysoftware/AgentDVR-Plugins. Vous aurez besoin d'une version récente de Visual Studio pour les compiler.

Nous recommandons de commencer par le plugin de démonstration comme base. Assurez-vous que vous avez la dernière version d'Agent installée. Après avoir compilé le plugin de démonstration, copiez tous les fichiers du dossier de sortie dans Agent\Plugins\Demo\. Redémarrez Agent DVR, modifiez une caméra, et allez à l'onglet Plugins. Activez le plugin, sélectionnez Demo dans la liste déroulante, et cliquez sur le bouton "..." pour le configurer.

Le plugin de démonstration est entièrement compatible inter-plateformes et met en avant les fonctionnalités étendues que vous pouvez créer avec les plugins. Il inclut des effets vidéo en direct, des superpositions graphiques, un contrôle de volume en direct, et l'intégration avec le sous-système d'Événements d'Agent DVR. Le menu du plugin fournit des informations sur le fonctionnement de divers contrôles d'entrée.

Notes sur les plugins pour les développeurs:

Configuration: Agent DVR utilise JSON et un fichier de classe pour le stockage des paramètres. Pour configurer les paramètres, modifiez le fichier config.cs.

Le rendu de configuration d'Agent DVR repose sur des fichiers .json. Modifiez config_en.json dans le répertoire json pour l'affichage de l'interface utilisateur, où vous pouvez ajouter plusieurs sections rendues sous forme d'onglets. Les champs clé 'bindto' dans json établissent un lien vers les champs de configuration. Agent DVR automatise le rendu des contrôles, le stockage des paramètres et les mises à jour.

Ajouter 

"live": true
aux entrées json active les mises à jour immédiates sans attendre le clic du bouton OK, ce qui est idéal pour l'ajustement en direct. Le champ 'converter' utilise 'PopulateResponse' dans Utils.cs pour le formatage des valeurs.

Support média: Choisissez de traiter la "vidéo", l'audio, ou les deux. Le champ 'Supports' dans Main.cs peut être codé en dur.

Traitement continu: Chaque image vidéo et audio de l'appareil est envoyée au plugin pour analyse ou traitement, comme démontré dans la démo.

Traitement du mouvement/d'alerte: Traitez les images lors du mouvement ou d'alertes en utilisant la méthode 'ProcessEvent' dans le plugin de démonstration. Cela permet le traitement des images uniquement lors de ces événements.

Événements personnalisés: La méthode 'GetCustomEvents' dans votre plugin doit retourner une liste des événements personnalisés qu'il génère. Ces événements apparaissent ensuite sous Actions dans la liste 'Si' de l'interface utilisateur d'Agent DVR. Déclenchez ces événements avec un élément 'Result', en spécifiant le nom de l'action et optionnellement MSG, Tag, Filename, et AIJSON.

Alerte, Détection et Tag: Déclenchez des alertes ou détectez des événements en ajoutant un Result avec "alert" ou "detect" comme eventName. Marquez les enregistrements en cours avec un eventName 'tag' et définissez Tags selon les besoins.

Appels API: Agent DVR initialise les plugins avec les informations de l'appareil et le port du serveur local, utile pour les commandes API de l'appareil. Les propriétés AppDataPath et AppPath sont également définies pour l'affichage ou les emplacements de sauvegarde de fichiers.

Distribution: Vous avez créé un plugin cool ou utile? Partagez-le avec nous et contribuez à la communauté!