Guía del usuario: Configuración Acciones

Sobre

Las acciones en Agent DVR son respuestas a eventos específicos, como alertas de cámara/IA o desconexiones de dispositivos. Para acceder y configurar las acciones, edite un dispositivo y navegue hasta la sección Acciones en el menú.

Haga clic en 'Agregar' para crear una nueva acción. Se le presentará una pantalla de configuración similar a las imágenes a continuación:

Interfaz de acciones de IA
Interfaz de tarea de IA

Hay una amplia gama de eventos que pueden activar acciones. Se pueden asociar múltiples acciones con cada evento, y puede incorporar varias etiquetas dentro de estas acciones para crear respuestas dinámicas.

Configurando una acción
  • Activo: Alternar esto para activar o desactivar la acción. Alternativamente, puede utilizar el Programa y el API con comandos como actionOn, actionOff y actionRun, utilizando el ID que se muestra arriba.
  • Si: Seleccione una acción disponible (ver más abajo).
  • Con etiqueta: (Eventos de IA). Esto se utiliza principalmente con acciones de IA. Por ejemplo, si selecciona IA: Objeto encontrado e ingresa gato aquí, la acción se activará solo cuando se detecte un gato.
  • En zonas: (Eventos de IA). Especifique zonas de movimiento (desde la pestaña de detección de movimiento) para filtrar los objetos detectados. Por ejemplo, seleccionando la zona 1 y gato como etiqueta, la acción se activará solo cuando se detecte un gato en la zona 1. Deje en blanco para incluir todas las zonas.
  • Temporizador de repetición: Esto suprime el evento si se ha activado dentro de este intervalo y también reinicia el temporizador. Por ejemplo, con 'Vehículo detectado' como disparador y un tiempo de espera de 30 segundos, se enviará una alerta una vez, con alertas posteriores en pausa hasta que haya un intervalo de 30 segundos en el tráfico detectado.
  • Agregar tarea: Haga clic para agregar una tarea. Puede asignar múltiples tareas a una acción (v4.5.5.0+).

Acciones disponibles

Los eventos para los que puedes configurar acciones son los siguientes:
  • AI: Servidor caído (el servidor de AI ha devuelto un error - el evento se activará después de que las solicitudes hayan fallado 3 veces y no se repetirá hasta que el servidor vuelva a estar en línea)
  • AI: Servidor en funcionamiento (el servidor de AI ha salido del estado de error)
  • AI: Reconocimiento facial
  • AI: Rostro no reconocido
  • AI: Reconocimiento de matrículas
  • AI: Matrícula no reconocida
  • AI: Objeto encontrado
  • AI: Objeto no encontrado
  • AI: Sonido reconocido (solo para micrófonos)
  • Alerta
  • Alerta finalizada
  • Alerta manual
  • Detección de movimiento
  • Movimiento finalizado
  • Ninguno - úsalo si quieres activar acciones con el comando "Ejecutar acción de alerta" en la programación
  • Estado lógico ONVIF ON - úsalo para, por ejemplo, iniciar y detener la grabación basándose en actualizaciones del estado lógico ONVIF (requiere que el tipo de detector de movimiento esté configurado en ONVIF)
  • Estado lógico ONVIF OFF
  • Foto tomada
  • Posición PTZ aplicada
  • Reconexión fallida
  • Grabación finalizada
  • Grabación iniciada
  • Fuente desconectada
  • Fuente reconectada
  • Apagar dispositivo
  • Encender dispositivo
  • Sistema: UI conectada - cuando alguien abre un navegador para ver tu sistema)
  • Sistema: UI desconectada - cuando se cierra la sesión (ocurre aproximadamente un minuto después de que el navegador se desconecte)

Detectando Merodeo

Para detectar merodeo (personas u objetos que permanecen en un lugar durante un cierto período de tiempo) deberás configurar lo siguiente:

  • Configurar un servidor de IA en la configuración del servidor
  • Agregar una Acción para IA: Merodeo Detectado
  • Establecer la etiqueta que estás buscando, que normalmente sería persona, pero podrías usar coche para detectar coches estacionados en un área por demasiado tiempo, o maleta para equipaje abandonado o un gato sentado en tu sofá. Puedes usar múltiples etiquetas aquí, por ejemplo coche,autobús,camión. Para ver una lista de objetos disponibles para encontrar, consulta la lista de clases en el reconocimiento de objetos cuando edites la cámara.
  • Especificar las zonas en las que deseas buscar el objeto. Utiliza la pestaña del detector para dibujar zonas de movimiento.
  • Especificar el número de segundos que tolerarás que el objeto detectado esté en la zona.
  • Agregar Tareas para realizar cuando se cumplan las condiciones.

Agregando Eventos Personalizados

Más allá de los eventos predefinidos, puedes crear eventos personalizados agregando Tareas. Una vez que se crea una tarea, aparecerá en la lista de Eventos. Luego puedes configurar una Acción para responder a esta tarea. Las tareas se pueden activar desde la página en vivo en la interfaz de usuario (seleccionando una cámara y luego haciendo clic en el ícono de tarea en la parte inferior izquierda) o a través del comando Acción: Ejecutar que se encuentra en el Programa.

Tareas personalizadas

Las tareas son comandos que puedes asignar a dispositivos para activar manualmente Acciones. Las acciones pueden llamar a APIs de terceros para realizar tareas como abrir puertas, encender luces, reproducir sonidos, etc. Para agregar, eliminar y ejecutar tareas, selecciona un dispositivo en la página en vivo y haz clic en el ícono de la tarea .

Configuración de una tarea:
  • Ingresa un texto para describir la tarea, por ejemplo "Encender luces" y haz clic en el botón +. Haz clic en OK
  • Haz clic para editar el dispositivo usando el ícono de edición . Selecciona el panel de Acciones en el editor usando el menú en la parte superior derecha.
  • Agrega una acción. Selecciona la condición "Si" para que sea la tarea que acabas de crear (las tareas se muestran al final de la lista de acciones disponibles) y luego configura lo que deseas que haga la tarea.
  • Haz clic en OK
  • Ahora puedes activar manualmente esta acción desde la vista en vivo haciendo clic en el botón de tareas y luego en la flecha de avance junto a la tarea.

También puedes activar tareas a través de la API de Agent DVR.

Tareas Disponibles

La lista de acciones disponibles que puedes realizar (bajo Then) es:

  • Alerta - activa una alerta en el dispositivo
  • Pitido - reproduce un pitido a través del altavoz de la PC local
  • Ir a Preset (Preset de PTZ)
  • Llamar URL - llama a cualquier URL con un token de autenticación opcional. Puedes llamar a la API de Agent DVR aquí. Si tienes marcada la opción Proteger API en la configuración del servidor, deberás proporcionar un encabezado de autorización. Para hacer esto, necesitarás agregar una Cuenta de Usuario a través de la Configuración del Servidor e ingresar un valor de Encabezado de Autenticación Básica:
BASIC YWRtaW46YWRtaW4=
  • Ejecutar Comando
También ver comandos
Para agregar tus propios comandos/scripts, puedes añadir archivos .bat o .sh en el directorio de Comandos. Luego puedes pasar parámetros al archivo por lotes. Por ejemplo, para copiar todas las fotos a la raíz de la unidad D:

Crea un archivo de texto plano que contenga:
copy %1 D:\
Guárdalo como copyPhoto.bat (en Linux usa .sh - necesitarás hacer este archivo ejecutable usando chmod +x) en el Directorio de Agent/Comandos
Luego agrega una acción:
si: "Foto Tomada"
entonces: "Ejecutar Comando"
Archivo: copyPhoto
Parámetros: "{FILENAME}"

  • MQTT - enviar un mensaje MQTT
  • Imagen MQTT - enviar una imagen en vivo en bruto en bytes jpeg a un tema
  • Mensaje de Red
  • Inicio RTMP - iniciar la transmisión RTMP para este dispositivo
  • Detener RTMP - detener la transmisión RTMP para este dispositivo
  • Enviar Email (con adjuntos de imagen opcionales)
  • Enviar Email con video (especificar duración - esto incluye un buffer del evento). v4.9.8.0+
  • Enviar Notificación Push
  • Enviar SMS
  • Establecer Área de Detección de Movimiento (seleccionar el Área que definió en el Detector)
  • Mostrar Mensaje - muestra mensaje en navegadores web de visualización
  • Sonido (en la computadora de Agent)
  • Sonido (a través de la Cámara)
  • Sonido (a través del navegador web)
Debido a la seguridad del navegador, esto requiere interacción con la página web primero (por ejemplo, haciendo clic en algo). Para solucionar esto en Chrome, vaya a chrome://settings/content/sound y agregue la dirección de su servidor (o nuestro sitio web si está utilizando el portal remoto) a la Lista Permitida.
  • Iniciar grabación en (algún dispositivo) - grabará hasta que se detenga.
  • Iniciar transmisión RTMP.
  • Iniciar lapso de tiempo en (algún dispositivo)
  • Detener grabación en (algún dispositivo)
  • Detener transmisión RTMP
  • Detener lapso de tiempo en (algún dispositivo)
  • Encender objeto
  • Apagar objeto
  • Cambiar Perfil
  • Texto a voz (en la computadora de Agent - requiere una cuenta en iSpyConnect.com ya que el texto se renderiza a través de llamadas a servicios web)
  • Texto a voz (a través del navegador web)
Debido a la seguridad del navegador, esto requiere interacción con la página web primero (por ejemplo, haciendo clic en algo)
  • Texto a Voz (a través de la cámara)
  • Activar Alerta En (otro dispositivo)
  • Activar Detección En (otro dispositivo)
  • Activar Reconocimiento Facial En (otro dispositivo)
  • Activar Reconocimiento de Matrículas En (otro dispositivo)
  • Activar Reconocimiento de Objetos En (otro dispositivo)
  • Activar Grabación En (otro dispositivo). Esto grabará hasta el ajuste de tiempo de espera de grabación por activación en la pestaña de Grabación. Este tiempo de espera se reinicia con cada llamada de acción de grabación por activación.

Usando etiquetas

Las etiquetas en los campos Then de las acciones de Agent DVR te permiten crear respuestas dinámicas. Es importante tener en cuenta que algunas etiquetas son específicas del contexto. Por ejemplo, {FILENAME} no está disponible para eventos de alerta y {AI} no está disponible si el evento no fue generado por un servidor de IA.

  • {ID}: El ID del objeto, visible en la parte superior izquierda del editor al editar una cámara o micrófono en Agent.
  • {OT}: El ID del tipo de objeto. 1 para micrófono, 2 para cámara.
  • {FILENAME}: El nombre de archivo. Aplicable a eventos como Grabación Iniciada, Grabación Finalizada y Captura de Imagen. Es la ruta completa local del archivo.
  • {CURRENT_RECORDING}: El nombre de archivo de la grabación actual. Ruta completa local del archivo. (v5.0.6.0+)
  • {MSG}: El nombre del evento que activó la acción, por ejemplo, "Alerta Manual".
  • {NAME}: El nombre del dispositivo (encontrado en la pestaña General).
  • {GROUPS}: Los grupos a los que pertenece el dispositivo (encontrado en la pestaña General).
  • {LOCATION}: La ubicación de la cámara (encontrada en la pestaña General).
  • {LEVEL} y {DB}: El nivel de movimiento o audio. {DB} es el nivel de decibelios para dispositivos de audio. Medido cuando se ejecuta la acción. (v4.3.7.0+)
  • {AI}: Una lista separada por comas de objetos detectados de IA, placas de LPR o rostros detectados de Reconocimiento Facial.
  • {AIJSON}: Datos JSON devueltos de DeepStack o LPR.
  • {ZONE}: La zona que activó la acción (vacía si no se utiliza IA o una lista CSV para múltiples zonas como 1,2,3).
  • {BASE64IMAGE}: Datos de imagen en vivo en formato URL. Son los bytes codificados en base64 en bruto, por lo que se deben formatear según sea necesario (por ejemplo,
    p=data:image/jpeg;base64,{BASE64IMAGE}
    ). (Disponible v4.5.9.0+)

Por ejemplo, con un evento AI: Reconocimiento Facial, una tarea Then Texto a Voz con el texto

Hola {AI}
saludará a cada persona reconocida por su nombre.

Ten cuidado con las alertas de activación en acciones para evitar rutas cíclicas: por ejemplo, una alerta en la Cámara 1 activa una alerta en la Cámara 2, que a su vez activa una alerta en la Cámara 1.

Una vez que se agrega una acción, el control de tabla muestra un resumen de tus acciones. Una marca de verificación verde indica una acción activa.

Ejemplo de tabla de acciones

Puedes usar el programador para habilitar/deshabilitar acciones o activar una acción. Por ejemplo, puedes programar una acción para enviar un correo electrónico con dos imágenes en un momento específico.

Programar Acciones

En este ejemplo, se agregó una acción para enviar un correo electrónico con 2 imágenes, configurado en evento Ninguno. Luego se creó una entrada de programación para ejecutar esa acción a las 8AM los domingos y sábados.

Agent DVR Guía del usuario
Filtro Aplicado