Agent DVR: Plugins

Instalación de complementos

Los complementos son módulos adicionales opcionales que amplían Agent DVR con funciones extra de procesamiento de audio y vídeo, como escaneo de códigos de barras, superposiciones meteorológicas y filtros de audio.

La forma más fácil de instalar complementos es a través del portal web remoto. Una vez conectado, haga clic en el icono de Servidor en la esquina superior derecha y navegue a "Complementos" en Sistema. Aquí puede seleccionar el complemento que desea usar en el menú desplegable de la esquina superior derecha y haga clic en "Instalar" para comenzar.

¿Prefiere instalar manualmente? ¡Sin problema! Puede compilar los complementos desde el código fuente y luego copiar la salida compilada a Agent/Plugins/PLUGINNAME. Este método le proporciona más control sobre el proceso de instalación.

Complementos disponibles

Agent DVR viene equipado con funciones avanzadas de procesamiento de vídeo como integración de CodeProject AI, junto con seguimiento avanzado de objetos, reconocimiento de audio y detectores de conteo. Para mejorar aún más su experiencia, ofrecemos una variedad de complementos que puede usar en AgentDVR para ampliar su funcionalidad.

Lista de Complementos

Códigos de barras

Escanee prácticamente cualquier código de barras desde una cámara (solo Windows).

Eventos generados: Código de barras reconocido
Compatible con: Vídeo

captura de pantalla

Ganancia

Aplique filtros de banda en directo en el audio procedente de dispositivos de audio.

Eventos generados: Ninguno
Compatible con: Audio

captura de pantalla

Retraso en directo

Añade un retraso al audio y vídeo en directo (útil para análisis de deportes).

Eventos generados: Ninguno
Compatible con: Vídeo, Audio

captura de pantalla

Meteorología

Añade una superposición de estado meteorológico al vídeo en directo según su ubicación. Genere eventos si el tiempo cambia (por ejemplo, si se acerca una tormenta, si las ráfagas de viento o los límites de temperatura se superan). Puede personalizar el diseño y el modo de visualización de los datos meteorológicos desde solo un icono hasta los detalles completos.

La configuración de meteorología utiliza una cadena de formato para organizar la información. Estos son algunos ejemplos de cadenas de formato que puede utilizar:

Información completa:

{icon}{main}: {description} 
 Viento: {wind} Ráfaga: {gust} 
 Temp: {temp} Sensación térmica: {feelsLike} 
 Humedad: {humidity} UVI: {uvi}

Solo icono:

{icon}

Una línea:

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

Eventos generados: Temperatura alta, Ráfaga, Estado
Compatible con: Vídeo

captura de pantalla
Si utiliza un complemento de audio como Listen en una cámara, deberá editar la cámara, seleccionar la pestaña Audio y hacer clic para configurar el micrófono. Desde allí puede acceder a la pestaña Complementos para dispositivos de audio. Alternativamente, puede hacer clic en el icono Servidor, seleccionar Editar dispositivos y editar el micrófono en esa lista.

Configurar Complementos

¿Listo para aprovechar el poder de los complementos? Simplemente añada un dispositivo (cámara o micrófono) y acceda a sus ajustes de edición. Busque la pestaña Complemento en el menú desplegable en la parte superior derecha. Aquí puede seleccionar el complemento deseado y haga clic en el botón "..." para configurarlo según sus necesidades.

Algunos complementos generan eventos a los que puede adjuntar acciones. El complemento Weather, por ejemplo, genera un evento Gust cuando los vientos con ráfagas superan un valor especificado (configurable en el complemento). Editar la cámara y navegar a la pestaña Acciones le ofrece opciones para responder a esto - activar una alarma o iniciar una grabación, por ejemplo. Simplemente seleccione el nombre del complemento: evento (por ejemplo Weather: Gust) en el cuadro Si y asigne una acción.

Crea tu propio Complemento

Los complementos son módulos dinámicos que puedes añadir a Agent DVR para mejorar sus capacidades de procesamiento de audio y vídeo. Con los complementos, aplica efectos en tiempo real, superposiciones, genera eventos e impulsa alertas en Agent DVR, permitiendo acciones personalizadas avanzadas.

Para comenzar a crear complementos para Agent DVR, empieza clonando nuestros complementos de código abierto en https://github.com/ispysoftware/AgentDVR-Plugins. Necesitarás una versión reciente de Visual Studio para compilarlos.

Te recomendamos comenzar con el complemento de demostración como base. Asegúrate de tener instalada la última versión de Agent. Después de compilar el complemento de demostración, copia todos los archivos de la carpeta de salida a Agent\Plugins\Demo\. Reinicia Agent DVR, edita una cámara y ve a la pestaña Complementos. Habilita el complemento, selecciona Demo en el menú desplegable y haz clic en el botón "..." para configurarlo.

El complemento Demo es totalmente compatible multiplataforma y muestra la amplia funcionalidad que puedes crear con complementos. Incluye efectos de vídeo en directo, superposiciones gráficas, control de volumen en directo e integración con el subsistema de eventos de Agent DVR. El menú del complemento proporciona información sobre cómo funcionan varios controles de entrada.


Notas de complementos para desarrolladores:

Configuración: Agent DVR utiliza JSON y un archivo de clase para el almacenamiento de ajustes. Para configurar los ajustes, edita el archivo config.cs.

La representación de la configuración de Agent DVR se basa en archivos .json. Edita config_en.json en el directorio json para la visualización de la interfaz de usuario, donde puedes añadir múltiples secciones representadas como pestañas. Los campos clave 'bindto' en json se vinculan a los campos de configuración. Agent DVR automatiza la representación de controles, el almacenamiento de ajustes y las actualizaciones.

Añadir "live": true a las entradas json habilita actualizaciones inmediatas sin esperar al clic del botón Aceptar, lo cual es excelente para la sintonización en directo. El campo 'converter' utiliza 'PopulateResponse' en Utils.cs para el formato de valores.

Compatibilidad de medios: Elige procesar "vídeo", "audio" o ambos. El campo 'Supports' en Main.cs se puede codificar.

Procesamiento continuo: Cada fotograma de vídeo y audio del dispositivo se envía al complemento para análisis o procesamiento, como se demuestra en la demostración.

Procesamiento de movimiento/alertas: Procesa fotogramas en movimiento o alertas utilizando el método 'ProcessEvent' en el complemento de demostración. Esto permite el procesamiento de fotogramas solo durante estos eventos.

Eventos personalizados: El método 'GetCustomEvents' en tu complemento debe devolver una lista de eventos personalizados que genera. Estos eventos aparecen entonces en Acciones en la lista 'Si' de la interfaz de usuario de Agent DVR. Impulsa estos eventos con un elemento 'Resultado', especificando el nombre de la acción y opcionalmente MSG, Etiqueta, Nombre de archivo y AIJSON.

Alerta, detección y etiqueta: Impulsa alertas o detecta eventos añadiendo un Resultado con "alert" o "detect" como eventName. Etiqueta grabaciones en curso con un eventName 'tag' y establece Etiquetas según sea necesario.

Llamadas API: Agent DVR inicializa complementos con información del dispositivo y puerto del servidor local, útil para comandos API del dispositivo. Las propiedades AppDataPath y AppPath también se establecen para ubicaciones de visualización o almacenamiento de archivos.

Distribución: ¿Creaste un complemento interesante o útil? Compártelo con nosotros y contribuye a la comunidad.