Configuración: Acciones

Las acciones en Agent DVR son respuestas a eventos específicos, como alertas de cámaras/IA o desconexiones de dispositivos. Úsalas para responder automáticamente, por ejemplo activando una alarma, encendiendo luces a través de una URL de enchufe inteligente o desencadenando grabación en otra cámara. Para acceder y configurar acciones, edita un dispositivo y navega a la sección Acciones en el menú.

Haz clic en "Añadir" para crear una nueva acción. Se te presentará una pantalla de configuración similar a las imágenes que se muestran a continuación:

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

Configurar una acción

• Activo: Activa o desactiva la acción. Alternativamente, puedes usar la Programación y la API con comandos como actionOn, actionOff y actionRun, usando el ID que se muestra arriba.
• Nombre: Un nombre opcional para la acción.
• Si: Selecciona un evento disponible (véase a continuación).
• Con etiqueta: (Eventos de IA). Se usa principalmente con eventos de IA. Por ejemplo, si seleccionas IA: Objeto encontrado e introduces gato aquí, la acción se activará solo cuando se detecte un gato. Ten en cuenta que la etiqueta coincide según el idioma seleccionado en Configuración del servidor - General.
• Regla: Elige si varias etiquetas deben coincidir todas (Y) o si cualquiera puede coincidir (O).
• En zonas: (Eventos de IA). Especifica zonas de movimiento (de la pestaña de detección de movimiento) para filtrar los objetos detectados. Por ejemplo, si seleccionas la zona 1 y gato como etiqueta, la acción se activará solo cuando se detecte un gato en la zona 1. Deja en blanco para incluir todas las zonas.
• Tiempo de espera de repetición: Esto suprime el evento si se ha generado dentro de este intervalo y también reinicia el temporizador. Por ejemplo, con "Vehículo detectado" como desencadenante y un tiempo de espera de 30 segundos, se enviará una alerta una vez, con las alertas posteriores pausadas hasta que haya una brecha de 30 segundos en el tráfico detectado.
• Añadir tarea: Haz clic para añadir una tarea. Puedes asignar múltiples tareas a una acción (v4.5.5.0+).

Las acciones pueden responder a una amplia gama de eventos del sistema, dispositivo e IA. Los eventos para los que puedes configurar acciones son:

• Servidor de IA caído (el servidor de IA 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)
• Servidor de IA activo (el servidor de IA ha salido del estado de error)
• IA: Preguntar a la IA resultado positivo (encontró un objeto que estabas buscando)
• IA: Preguntar resultado a la IA (se activa en cualquier respuesta de Preguntar a la IA, sea positiva o no)
• IA: Describir respuesta recibida (la IA describió una imagen - la descripción está en las etiquetas {MESSAGE} y {AIJSON})
• IA: Cara reconocida
• IA: Cara no reconocida
• IA: Matrícula reconocida
• IA: Matrícula no reconocida
• IA: Merodeo detectado
• IA: Objeto encontrado
• IA: Objeto no encontrado
• IA: Sonido reconocido (solo micrófonos)
• Alerta
• Alerta finalizada
• Llamada URL: respuesta recibida - Se activa por la respuesta que obtienes cuando se ejecuta una tarea "Llamar URL", permitiéndote responder con otras tareas.
• Alerta manual
• Movimiento detectado
• Movimiento finalizado
• Ninguno - utiliza esto si deseas activar la acción tú mismo con el comando "Acción: Ejecutar" en el programa
• Evento ONVIF activado - utiliza esto, por ejemplo, para iniciar y detener la grabación en función de actualizaciones de estado lógico ONVIF (requiere que el tipo de detector de movimiento sea ONVIF)
• Evento ONVIF desactivado
• Evento ONVIF recibido (se activa en cualquier evento ONVIF de la cámara)
• Foto capturada
• Preajuste PTZ aplicado
• Error al reconectar
• Error al grabar
• Grabación finalizada
• Grabación iniciada
• Fuente desconectada
• Fuente reconectada
• Fuente cubierta/manipulada
• Apagar dispositivo
• Encender dispositivo
• Sistema: Armado
• Sistema: Desarmado
• Sistema: Sin UI conectada - cuando se cierra la última sesión de UI
• Sistema: Perfil aplicado
• Sistema: UI conectada - cuando alguien abre un navegador para ver tu sistema
• Sistema: UI desconectada - cuando se cierra la sesión (sucede aproximadamente un minuto después de que el navegador se desconecte)
• Lapso de tiempo iniciado
• Lapso de tiempo detenido

Los eventos de complementos y tareas personalizadas que hayas añadido también aparecen al final de esta lista.

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

• Configure un servidor de IA en la configuración del servidor
• Añada una Acción para IA: Merodeo detectado
• Establezca la etiqueta que está buscando - normalmente sería persona pero podría usar coche para detectar coches estacionados en un área durante demasiado tiempo o maleta para equipaje abandonado o un gato sentado en su sofá. Puede usar múltiples etiquetas aquí, por ejemplo coche,autobús,camión. Para ver una lista de objetos disponibles a buscar, consulte la lista de clases en reconocimiento de objetos cuando edite la cámara.
• Especifique las zonas donde desea buscar el objeto. Use la pestaña detector para dibujar zonas de movimiento.
• Especifique el número de segundos que tolerará que el objeto detectado permanezca en la zona.
• Añada Tareas para ejecutar cuando se cumplan las condiciones.

Nota: El detector de merodeo utiliza la configuración del reconocimiento de objetos como verificar esquinas y superposición

Más allá de los eventos preestablecidos, puede crear eventos personalizados añadiendo Tareas. Una vez que se crea una Tarea, aparecerá en la lista de Eventos. Luego puede configurar una Acción para responder a esta Tarea. Las Tareas se pueden activar desde la página EN DIRECTO en la interfaz (seleccionando una Cámara y luego haciendo clic en el icono de Tarea en la Inferior izquierda) o a través del comando Acción: EJECUTAR que se encuentra en la Programación.

Las Tareas son Comandos que puede adjuntar 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 añadir, eliminar y ejecutar tareas, seleccione un Dispositivo en la página EN DIRECTO y haga clic en el icono de tareas .

Configuración de una tarea:

• Ingrese un Texto para describir la Tarea, por ejemplo "Encender Luces" y haga clic en el botón +. Haga clic en Aceptar
• Haga clic para editar el Dispositivo utilizando el icono Editar . Seleccione el panel Acciones en el editor utilizando el menú en la esquina Superior derecha.
• Añada una Acción. Seleccione la condición "Si" para que sea la Tarea que acaba de crear (las tareas se muestran al final de la lista de Acciones Disponibles) y luego configure lo que desea que haga la Tarea.
• Haga clic en Aceptar
• Ahora puede activar manualmente esta Acción desde la vista en directo haciendo clic en el botón Tareas y clics en el botón flecha Siguiente junto a la Tarea.

También puede activar Tareas a través de la API de Agent DVR.

Las tareas son lo que realiza una acción cuando se activa su evento, desde enviar una alerta por correo electrónico o notificación push hasta controlar la grabación en otros dispositivos. La lista de tareas disponibles que puede realizar (en Entonces) es:

• Alerta - activa una alerta en el dispositivo
• Pitido - reproduce un pitido a través del altavoz del ordenador Agent DVR
• Llamar URL - llama a cualquier URL con un token de autenticación opcional. Puede llamar a la API de Agent DVR aquí, o enviar alertas a Discord, Slack, ntfy y servicios similares (consulte Webhooks). Si tiene Proteger API marcado en la configuración del servidor, deberá proporcionar un encabezado de autorización. Para hacerlo, deberá añadir una Cuenta de usuario mediante Configuración del servidor e introducir un valor de encabezado de autenticación básica:
  Generar

• Ejecutar comando

copy %1 D:\

• Subir grabación actual a la nube - carga la grabación actual al proveedor de nube del dispositivo
• Retraso - pausa antes de ejecutar la siguiente tarea
• Activar/Desactivar Ask AI
• Activar/Desactivar reconocimiento facial
• Activar/Desactivar LPR
• Activar/Desactivar reconocimiento de objetos
• Activar/Desactivar patrullaje (patrullaje PTZ en un dispositivo)
• Activar/Desactivar reconocimiento de sonido
• Subir grabación actual por FTP - carga la grabación actual al servidor FTP del dispositivo
• Registrar - escribir un mensaje en el registro de Agent DVR
• MQTT - enviar un mensaje MQTT
• Imagen MQTT - enviar una imagen en vivo sin procesar en bytes jpeg a un tema
• Mensaje de red
• Comando PTZ - mover la cámara a un preestablecido o ejecutar un comando PTZ
• Enviar correo electrónico (con archivos adjuntos de imagen opcionales)
• Enviar correo electrónico con vídeo (especifique la duración - esto incluye un búfer del evento). v4.9.8.0+
• Enviar notificación push
• Enviar SMS
• Establecer área del detector de movimiento (seleccione el área que definió en el detector)
• Mostrar mensaje - muestra el mensaje en los navegadores web de visualización
• Sonido (en el ordenador Agent DVR)
• Sonido (a través de la cámara)
• Sonido (a través del navegador web)

• Iniciar grabación al (algún dispositivo) - grabará hasta que se detenga.
• Iniciar streaming RTMP
• Iniciar timelapse en (algún dispositivo)
• Detener grabación en (algún dispositivo)
• Detener streaming RTMP
• Detener timelapse en (algún dispositivo)
• Encender dispositivo
• Apagar dispositivo
• Sistema: aplicar perfil - cambiar perfil
• Sistema: armar
• Sistema: desarmar
• Etiquetar grabación - añadir una etiqueta a la grabación actual
• Tomar foto al (algún dispositivo)
• Texto a voz (en el ordenador Agent DVR - requiere una cuenta de iSpyConnect.com ya que el texto se procesa mediante llamadas de servicio web)
• Texto a voz (a través del navegador web)

• Texto a voz (a través de la cámara)
• Activar codificación adaptativa al (otro dispositivo)
• Activar alerta al (otro dispositivo)
• Activar Ask AI (otro dispositivo)
• Activar reconocimiento de audio (otro dispositivo)
• Activar detección al (otro dispositivo)
• Activar reconocimiento facial (otro dispositivo)
• Activar LPR (otro dispositivo)
• Activar reconocimiento de objetos (otro dispositivo)
• Activar grabación (con tiempo de espera) (otro dispositivo). Esto grabará hasta el parámetro de tiempo de espera de grabación activada en la pestaña Grabación. Este tiempo de espera se reinicia con cada llamada de acción de grabación activada.
• IU: Cambiar vista - cambiar las interfaces de usuario conectadas a una vista diferente

Las etiquetas en los campos Entonces de las acciones de Agent DVR permiten crear respuestas dinámicas. Es importante notar que algunas etiquetas son específicas del contexto. Por ejemplo, {FILENAME} no está disponible para Eventos de Alertas, y {AI} no está disponible si el evento no fue generado por un Servidor de IA.

• {ID}: El ID del objeto, visible en la esquina 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 e Instantánea realizada. Es la ruta local completa del archivo.
• {CURRENT_RECORDING}: El nombre de archivo de la grabación actual. Ruta local completa del archivo. (v5.0.6.0+)
• {MESSAGE}: El nombre del evento que activó la acción, p. ej., "Alerta manual".
• {EVENT}: El tipo de evento.
• {NAME}: El nombre del dispositivo (se encuentra en la pestaña General).
• {GROUPS}: Los grupos a los que pertenece el dispositivo (se encuentran en la pestaña General).
• {SERVER}: El nombre del servidor (desde Configuración del servidor).
• {ALERTID}: El ID de la alerta (-1 si no hay alerta asociada).
• {ALERTCOUNT}: El recuento de alertas del dispositivo.
• {TIME} y {DATE}: La hora y fecha actual en el servidor.
• {RECORDED}: "REC" si el dispositivo está grabando, en caso contrario vacío.
• {TAGS}: Las etiquetas asociadas al evento.
• {PLUGIN}: El mensaje de un evento de complemento.

• {LOCATION}: La ubicación de la cámara (se encuentra en la pestaña General).
• {LEVEL} y {DB}: El nivel de movimiento o audio. {DB} es el nivel en decibelios para dispositivos de audio. Se mide cuando se ejecuta la acción. (v4.3.7.0+)
• {AI}: Una lista separada por comas de objetos detectados desde IA, placas desde LPR, o caras detectadas desde Reconocimiento facial.
• {AIJSON}: Datos JSON devueltos desde IA o LPR.
• {ZONE}: La zona que activó la acción (vacía si no se usa IA o una lista CSV para varias zonas como 1,2,3).
• {BASE64IMAGE}: URL de datos de imagen en vivo. Son bytes codificados en base64 sin procesar, por lo que debe formatear según sea necesario, p. ej.,

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

  (Disponible v4.5.9.0+). Imagen en vivo redimensionada a 640px de ancho.
• {BASE64IMAGE-LG}: URL de datos de imagen en vivo. Son bytes codificados en base64 sin procesar, por lo que debe formatear según sea necesario, p. ej.,

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

  (Disponible v6.0.8.0+). Imagen en vivo redimensionada a 1280px de ancho.
• {BASE64IMAGE-NATIVE}: URL de datos de imagen en vivo. Son bytes codificados en base64 sin procesar, por lo que debe formatear según sea necesario, p. ej.,

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

  (Disponible v6.0.8.0+). Imagen en vivo nativa.
• {TRIPCOUNT}, {TRIPCOUNTLEFT} y {TRIPCOUNTRIGHT}: Los contadores de cruces de cuerda de seguridad (total, izquierda y derecha) sumados en todos los cables de seguridad de la cámara. 0 si la cámara no está utilizando el detector de cuerda de seguridad. (v7.7.4.0+)
• {TRIPJSON}: Los contadores de cuerda de seguridad como JSON con un desglose por cable, por ejemplo

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

  (v7.7.4.0+)

Por ejemplo, con un evento IA: Cara reconocida, una tarea Entonces Texto a voz con el texto

Hola {AI}

Nota: Si usa etiquetas {BASE64IMAGE} con un evento relacionado con archivos como "Foto tomada", utilizará la imagen de tamaño completo del archivo. De lo contrario, redimensionará la imagen de la vista en vivo actual.

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

Puede usar el programador para habilitar/deshabilitar acciones o activar una acción. Por ejemplo, podría programar una acción para enviar un correo electrónico con dos imágenes en una hora específica.

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