Configuração: Ações

Ações no Agent DVR são respostas a eventos específicos, como alertas de câmera/IA ou desconexões de dispositivos. Use-as para responder automaticamente, por exemplo acionando um alarme, ligando luzes através de uma URL de tomada inteligente ou acionando gravação em outra câmera. Para acessar e configurar Ações, edite um dispositivo e navegue até a seção Ações no menu.

Clique em 'Adicionar' para criar uma nova ação. Será apresentada uma tela de configuração semelhante às imagens abaixo:

Há uma ampla gama de eventos que podem desencadear ações. Múltiplas ações podem ser associadas a cada evento, e você pode incorporar várias tags nessas ações para criar respostas dinâmicas.

Configurando uma Ação

• Ativa: Alterne para ativar ou desativar a ação. Alternativamente, você pode usar o Cronograma e a API com comandos como actionOn, actionOff e actionRun, usando o ID mostrado acima.
• Nome: Um nome opcional para a ação.
• Se: Selecione um evento disponível (veja abaixo).
• Com tag: (Eventos de IA). Isso é principalmente usado com eventos de IA. Por exemplo, se você selecionar IA: Objeto Encontrado e inserir gato aqui, a ação será desencadeada apenas quando um gato for detectado. Observe que a tag faz correspondência com base no idioma selecionado em Configurações do Servidor - Geral.
• Regra: Escolha se múltiplas tags devem todas corresponder (E) ou se qualquer uma pode corresponder (OU).
• Em Zonas: (Eventos de IA). Especifique zonas de movimento (da aba de detecção de movimento) para filtrar os objetos detectados. Por exemplo, selecionando zona 1 e gato como tag, a ação será desencadeada apenas quando um gato for detectado na zona 1. Deixe em branco para incluir todas as zonas.
• Tempo de Repetição: Isso suprime o evento se ele foi levantado dentro deste intervalo e também reinicia o cronômetro. Por exemplo, com 'Veículo detectado' como gatilho e um tempo de espera de 30 segundos, um alerta será enviado uma vez, com alertas subsequentes pausados até haver um intervalo de 30 segundos no tráfego detectado.
• Adicionar Tarefa: Clique para adicionar uma tarefa. Você pode atribuir múltiplas tarefas a uma ação (v4.5.5.0+).

As ações podem responder a uma ampla gama de eventos do sistema, dispositivo e IA. Os eventos para os quais você pode configurar ações são:

• AI Server Down (o AI Server retornou um erro - o evento acionará após 3 falhas de solicitação e não se repetirá até que o servidor esteja online novamente)
• AI Server Up (o AI Server saiu do estado de erro)
• AI: Ask AI Positive Result (encontrou um objeto que você estava procurando)
• AI: Ask AI Result (acionado em qualquer resposta Ask AI, positiva ou não)
• AI: Describe Response Received (uma imagem foi descrita pela IA - a descrição está nas tags {MESSAGE} e {AIJSON})
• AI: Face Recognized
• AI: Face Not Recognized
• AI: License Plate Recognized
• AI: License Plate Not Recognized
• AI: Loiter Detected
• AI: Object Found
• AI: Object Not Found
• AI: Sound Recognized (apenas mics)
• Alert
• Alert Finished
• Call URL Response Received - é acionado pela resposta que você recebe quando uma tarefa "Call URL" é executada, permitindo que você responda com outras tarefas.
• Manual Alert
• Motion Detected
• Motion Finished
• None - use isso se desejar acionar a ação você mesmo com o comando "Action: Run" no schedule
• ONVIF Event ON - use isso para, por exemplo, iniciar e parar a gravação com base nas atualizações de estado lógico do ONVIF (requer que o tipo de detector de movimento seja definido como ONVIF)
• ONVIF Event OFF
• ONVIF Event Received (acionado em qualquer evento ONVIF da câmera)
• Photo Taken
• PTZ Preset Applied
• Reconnect Failed
• Recording Failed
• Recording Finished
• Recording Started
• Source Disconnected
• Source Reconnected
• Source Covered/ Tampered
• Switch Device Off
• Switch Device On
• System: Armed
• System: Disarmed
• System: No UI Connected - quando a última sessão de UI é fechada
• System: Profile Applied
• System: UI Connected - quando alguém abre um navegador para visualizar seu sistema
• System: UI Disconnected - quando a sessão é fechada (ocorre aproximadamente um minuto após a desconexão do navegador)
• Timelapse Started
• Timelapse Stopped

Qualquer evento de plugin e tarefas personalizadas que você adicionou também aparecem no final desta lista.

Para detectar permanência (pessoas ou objetos permanecendo em um lugar por um determinado período de tempo) você precisará configurar o seguinte:

• Configure um servidor AI nas configurações do servidor
• Adicione uma Ação para AI: Loiter Detected
• Defina a tag que você está procurando - geralmente seria person mas você pode usar car para detectar carros estacionados em uma área por muito tempo ou suitcase para bagagem deixada ou um cat sentado no seu sofá. Você pode usar várias tags aqui por exemplo car,bus,truck. Para uma lista de objetos disponíveis para encontrar veja a lista de classes no reconhecimento de objetos quando você edita a câmera.
• Especifique as zonas onde você deseja procurar o objeto. Use a aba do detector para desenhar zonas de movimento.
• Especifique o número de segundos que você tolerará o objeto detectado estar na zona.
• Adicione Tarefas para executar quando as condições forem atendidas.

Nota: O detector de permanência usa as configurações do reconhecimento de objetos como verificar cantos e overlay

Além dos eventos pré-definidos, você pode criar eventos personalizados adicionando Tarefas. Uma vez que uma tarefa é criada, ela aparecerá na lista de Eventos. Você pode então configurar uma Ação para responder a essa tarefa. As tarefas podem ser acionadas a partir da página ao vivo na interface do usuário (selecionando uma câmera e clicando no ícone de tarefa no canto inferior esquerdo) ou através do comando Ação: Executar encontrado na Agenda.

As tarefas são comandos que você pode associar a dispositivos para acionar manualmente Ações. As ações podem chamar APIs de terceiros para executar tarefas como abrir portas, acender luzes, reproduzir sons, etc. Para adicionar, excluir e executar tarefas, selecione um dispositivo na página Ao Vivo e clique no ícone de tarefas .

Configurando uma tarefa:

• Digite um texto para descrever a tarefa, por exemplo, "Acender Luzes" e clique no botão +. Clique em OK
• Clique para editar o dispositivo usando o ícone de edição . Selecione o painel de Ações no editor usando o menu no canto superior direito.
• Adicione uma ação. Selecione a condição "Se" para ser a tarefa que você acabou de criar (as tarefas são mostradas no final da lista de ações disponíveis) e, em seguida, configure o que você deseja que a tarefa faça.
• Clique em OK
• Agora você pode acionar manualmente essa ação na visualização ao vivo clicando no botão de tarefas e clicando no botão de seta ao lado da tarefa.

Você também pode acionar tarefas por meio da API do Agent DVR.

Tarefas são o que uma ação faz quando seu evento é disparado, desde enviar um alerta de email ou notificação push até controlar a gravação em outros dispositivos. A lista de tarefas disponíveis que você pode executar (em Então) é:

• Alerta - dispara um alerta no dispositivo
• Beep - toca um bip no alto-falante do computador Agent DVR
• Chamar URL - chama qualquer URL com um token Auth opcional. Você pode chamar a API Agent DVR aqui, ou enviar alertas para Discord, Slack, ntfy e serviços similares (veja Webhooks). Se você tiver Protect API marcado nas configurações do servidor, você precisará fornecer um cabeçalho de autorização. Para isso você precisará adicionar uma Conta de Usuário via Configurações do Servidor e inserir um valor de Cabeçalho de Autenticação Básica:
  Gerar

• Executar Comando

copy %1 D:\

• Upload na nuvem da gravação atual - faz upload da gravação atual para o provedor de nuvem do dispositivo
• Atraso - pausa antes de executar a próxima tarefa
• Ativar / Desativar Ask AI
• Ativar / Desativar Reconhecimento Facial
• Ativar / Desativar LPR
• Ativar / Desativar Reconhecimento de Objetos
• Ativar / Desativar Patrulha Ativada (patrulha PTZ em um dispositivo)
• Ativar / Desativar Reconhecimento de Som
• Upload FTP da gravação atual - faz upload da gravação atual para o servidor FTP do dispositivo
• Log - escreve uma mensagem no log do Agent DVR
• MQTT - envia uma mensagem MQTT
• Imagem MQTT - envia uma imagem ativa bruta em bytes jpeg para um tópico
• Mensagem de Rede
• Comando PTZ - move a câmera para uma predefinição ou executa um comando PTZ
• Enviar Email (com anexos de imagem opcionais)
• Enviar Email com Vídeo (especifique duração - isto inclui um buffer do evento). v4.9.8.0+
• Enviar Notificação Push
• Enviar SMS
• Definir Área do Detector de Movimento (selecione a Área que você definiu no Detector)
• Mostrar Mensagem - exibe mensagem nos navegadores web em visualização
• Som (no computador Agent DVR)
• Som (através da câmera)
• Som (através do navegador web)

• Iniciar Gravação Em (algum dispositivo) - gravará até ser parado.
• Iniciar Streaming RTMP
• Iniciar Timelapse Em (algum dispositivo)
• Parar Gravação Em (algum dispositivo)
• Parar Streaming RTMP
• Parar Timelapse Em (algum dispositivo)
• Switch Device On
• Switch Device Off
• Sistema: Aplicar Perfil - alterna Perfil
• Sistema: Armar
• Sistema: Desarmar
• Marcar Gravação - adiciona uma tag à gravação atual
• Tirar Foto Em (algum dispositivo)
• Conversão de Texto para Fala (no computador Agent DVR - requer uma conta iSpyConnect.com, pois o texto é renderizado via chamadas de webservice)
• Conversão de Texto para Fala (através do navegador web)

• Conversão de Texto para Fala (através da câmera)
• Disparar Codificação Adaptativa Em (outro dispositivo)
• Disparar Alerta Em (outro dispositivo)
• Disparar Ask AI (outro dispositivo)
• Disparar Reconhecimento de Áudio (outro dispositivo)
• Acionar Detecção (outro dispositivo)
• Acionar Reconhecimento Facial (outro dispositivo)
• Acionar LPR (outro dispositivo)
• Acionar Reconhecimento de Objetos (outro dispositivo)
• Acionar Gravação (com timeout) (outro dispositivo). Isto irá gravar até a configuração de timeout de gravação acionada na aba Gravação. Este timeout é redefinido a cada acionamento de gravação.
• UI: Alterar Visualização - mudar UIs conectadas para uma visualização diferente

Tags nos campos Then das ações do Agent DVR permitem criar respostas dinâmicas. É importante notar que algumas tags são específicas do contexto. Por exemplo, {FILENAME} não está disponível para Alert Events, e {AI} não está disponível se o evento não foi gerado por um servidor AI.

• {ID}: O ID do objeto, visível no canto superior esquerdo do editor ao editar uma câmera ou microfone no Agent.
• {OT}: O ID do tipo de objeto. 1 para Microfone, 2 para Câmera.
• {FILENAME}: O nome do arquivo. Aplicável a eventos como Recording Started, Recording Finished e Snapshot Taken. É o caminho local completo para o arquivo.
• {CURRENT_RECORDING}: O nome do arquivo da gravação atual. Caminho local completo para o arquivo. (v5.0.6.0+)
• {MESSAGE}: O nome do evento que acionou a ação, por exemplo, "Manual Alert".
• {EVENT}: O tipo de evento.
• {NAME}: O nome do dispositivo (encontrado na aba General).
• {GROUPS}: Os grupos aos quais o dispositivo pertence (encontrado na aba General).
• {SERVER}: O nome do servidor (de Server Settings).
• {ALERTID}: O ID do alerta (-1 se não houver alerta associado).
• {ALERTCOUNT}: A contagem de alertas do dispositivo.
• {TIME} e {DATE}: A hora e data atuais no servidor.
• {RECORDED}: "REC" se o dispositivo está gravando, caso contrário vazio.
• {TAGS}: As tags associadas ao evento.
• {PLUGIN}: A mensagem de um evento de plugin.

• {LOCATION}: A localização da câmera (encontrada na aba General).
• {LEVEL} e {DB}: O nível de movimento ou áudio. {DB} é o nível em decibéis para dispositivos de áudio. Medido quando a ação é executada. (v4.3.7.0+)
• {AI}: Uma lista separada por vírgula de objetos detectados de AI, placas de LPR, ou faces detectadas de Facial Recognition.
• {AIJSON}: Dados JSON retornados de AI ou LPR.
• {ZONE}: A zona que acionou a ação (vazia se não usar AI ou uma lista CSV para múltiplas zonas como 1,2,3).
• {BASE64IMAGE}: URL de dados de imagem ao vivo. São os bytes brutos codificados em base64, então formate conforme necessário, por exemplo,

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

  (Disponível v4.5.9.0+). Imagem ao vivo redimensionada para largura de 640px.
• {BASE64IMAGE-LG}: URL de dados de imagem ao vivo. São os bytes brutos codificados em base64, então formate conforme necessário, por exemplo,

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

  (Disponível v6.0.8.0+). Imagem ao vivo redimensionada para largura de 1280px.
• {BASE64IMAGE-NATIVE}: URL de dados de imagem ao vivo. São os bytes brutos codificados em base64, então formate conforme necessário, por exemplo,

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

  (Disponível v6.0.8.0+). Imagem ao vivo nativa.

Por exemplo, com um evento AI: Face Recognized, uma tarefa Then Text to Speech com o texto

Hello {AI}

Observação: Se você usar tags {BASE64IMAGE} com um evento relacionado a arquivo como "Photo Taken", ele usará a imagem em tamanho completo do arquivo. Caso contrário, ele redimensionará a imagem de visualização ao vivo atual.

Após adicionar uma ação, o controle de tabela exibe um resumo de suas ações. Uma marca verde indica uma ação ativa.

Você pode usar o scheduler para habilitar/desabilitar ações ou acionar uma ação. Por exemplo, você pode agendar uma ação para enviar um email com duas imagens em um horário específico.

Neste exemplo, uma ação foi adicionada para enviar um email com 2 imagens, definida como evento None. Em seguida, uma entrada de agenda foi criada para executar essa ação às 8AM no domingo e sábado.