Configuração: Ações

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

Clique em "Adicionar" para criar uma nova ação. Você será apresentado a uma tela de configuração semelhante às imagens abaixo:

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

Configurando uma ação

• Ativo: Alterne isso para ativar ou desativar a ação. Como alternativa, você pode usar o Agendamento 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 é usado principalmente com eventos de IA. Por exemplo, se você selecionar IA: Objeto encontrado e inserir gato aqui, a ação será disparada apenas quando um gato for detectado. Observe que a correspondência de tag é baseada no idioma selecionado em Configurações do servidor - Geral.
• Regra: Escolha se múltiplas tags devem corresponder todas (E) ou se qualquer uma pode corresponder (OU).
• Nas zonas: (Eventos de IA). Especifique zonas de movimento (da aba de detecção de movimento) para filtrar os objetos detectados. Por exemplo, selecionando a zona 1 e gato como a tag, a ação será disparada apenas quando um gato for detectado na zona 1. Deixe em branco para incluir todas as zonas.
• Tempo limite de repetição: Isso suprime o evento se ele tiver sido disparado dentro deste intervalo e também redefine o temporizador. Por exemplo, com "Veículo detectado" como disparador e um tempo limite de 30 segundos, um alerta será enviado uma vez, com alertas subsequentes pausados até que haja uma lacuna 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 variedade de eventos do sistema, dispositivo e IA. Os eventos para os quais você pode configurar ações são:

• Servidor de IA offline (o servidor de IA retornou um erro - o evento será disparado após 3 falhas de solicitação e não ocorrerá novamente até o servidor estar online)
• Servidor de IA online (o servidor de IA saiu do estado de erro)
• IA: Resultado positivo do Ask AI (encontrou um objeto que você estava procurando)
• IA: Resultado do Ask AI (é disparado em qualquer resposta do Ask AI, positiva ou não)
• IA: Resposta de descrição recebida (uma imagem foi descrita pela IA - a descrição está nas tags {MESSAGE} e {AIJSON})
• IA: Rosto reconhecido
• IA: Rosto não reconhecido
• IA: Placa reconhecida
• IA: Placa não reconhecida
• IA: Permanência suspeita detectada
• IA: Objeto encontrado
• IA: Objeto não encontrado
• IA: Som reconhecido (apenas microfones)
• Alerta
• Alerta finalizado
• Resposta de chamada de URL recebida - isto é disparado pela resposta que você obtém quando uma tarefa "Chamar URL" é executada, permitindo que você responda com outras tarefas.
• Alerta Manual
• Movimento detectado
• Movimento terminado
• Nenhum - use isto se você quiser disparar a ação você mesmo com o comando "Ação: Executar" no cronograma
• Evento ONVIF ATIVADO - use isto para, por exemplo, iniciar e parar gravação com base em atualizações de estado lógico ONVIF (requer que o tipo de detector de movimento esteja definido como ONVIF)
• Evento ONVIF DESATIVADO
• Evento ONVIF recebido (é disparado em qualquer evento ONVIF da câmera)
• Foto tirada
• Preset PTZ aplicado
• Falha na reconexão
• Falha na gravação
• Gravação finalizada
• Gravação iniciada
• Fonte desconectada
• Fonte reconectada
• Fonte coberta/adulterada
• Desligar dispositivo
• Ligar dispositivo
• Sistema: Armado
• Sistema: Desarmado
• Sistema: Nenhuma UI conectada - quando a última sessão de UI é fechada
• Sistema: Perfil aplicado
• Sistema: UI conectada - quando alguém abre um navegador para visualizar seu sistema
• Sistema: UI desconectada - quando a sessão é fechada (ocorre aproximadamente um minuto após a desconexão do navegador)
• Timelapse iniciado
• Timelapse parado

Eventos de plug-in e tarefas personalizadas que você adicionou também aparecem no final desta lista.

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

• Configure um Servidor de IA nas Configurações do servidor
• Adicione uma Ação para IA: Permanência suspeita detectada
• Defina a etiqueta que você está procurando - normalmente seria pessoa, mas você poderia usar carro para detectar carros estacionados em uma área por muito tempo ou mala para bagagem deixada ou um gato sentado no seu sofá. Você pode usar múltiplas etiquetas aqui, por exemplo carro,ônibus,caminhão. Para uma lista de objetos disponíveis para buscar, consulte a lista de classes no Reconhecimento de objetos quando você editar a Câmera.
• Especifique as Zonas onde você deseja procurar o objeto. Use a aba Detector de movimento para desenhar as 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 suspeita usa as configurações do Reconhecimento de objetos, como verificar cantos e Sobreposição

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

As Ações são comandos que você pode anexar aos dispositivos para disparar manualmente as 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 as Luzes" e clique no botão +. Clique em OK
• Clique para editar o dispositivo usando o ícone de edição . Selecione o painel Ações no editor usando o menu no canto superior direito.
• Adicione uma ação. Selecione a condição "Se" como a tarefa que você acabou de criar (as tarefas aparecem na parte inferior da lista de ações disponíveis) e então configure o que você deseja que a tarefa faça.
• Clique em OK
• Agora você pode disparar manualmente essa ação na visualização ao vivo clicando no botão de tarefas e clicando no botão de seta Ir ao lado da tarefa.

Você também pode disparar tarefas através da API do Agent DVR.

As tarefas são o que uma ação faz quando seu evento é acionado, desde enviar um alerta por e-mail 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 - aciona um alerta no dispositivo
• Bip - reproduz um bip pelo alto-falante do computador Agent DVR
• Chamar URL - chame qualquer URL com um token de autenticação opcional. Você pode chamar a API do Agent DVR aqui ou enviar alertas para Discord, Slack, ntfy e serviços similares (consulte Webhooks). Se você tiver Proteger API marcado nas configurações do servidor, será necessário fornecer um cabeçalho de autorização. Para fazer isso, será necessário adicionar uma Conta de usuário por meio das configurações do servidor e inserir um valor de Cabeçalho de autorização básica:
  Gerar

• Executar comando

copy %1 D:\

• Upload na nuvem da gravação atual - carregue a gravação atual no 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 em (patrulha PTZ em um dispositivo)
• Ativar / Desativar reconhecimento de som
• Upload da gravação atual via FTP - carregue a gravação atual no servidor FTP do dispositivo
• Log - escrever uma mensagem no registro do Agent DVR
• MQTT - enviar uma mensagem MQTT
• Imagem MQTT - enviar uma imagem ao vivo bruta em bytes jpeg para um tópico
• Mensagem de rede
• Comando PTZ - mover a câmera para uma predefinição ou executar um comando PTZ
• Enviar e-mail (com anexos de imagem opcionais)
• Enviar e-mail com vídeo (especifique a duração - isso 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 de visualização
• Som (no computador Agent DVR)
• Som (através da câmera)
• Som (através do navegador web)

• Iniciar gravação ao (algum dispositivo) - gravará até ser interrompido.
• Iniciar streaming RTMP
• Iniciar Timelapse em (algum dispositivo)
• Parar gravação em (algum dispositivo)
• Parar streaming RTMP
• Parar Timelapse em (algum dispositivo)
• Ligar dispositivo
• Desligar dispositivo
• Sistema: Aplicar perfil - alternar Perfil
• Sistema: Armar
• Sistema: Desarmar
• Etiquetar gravação - adicione uma etiqueta à gravação atual
• Tirar foto ao (algum dispositivo)
• Texto para fala (no computador Agent DVR - requer uma conta iSpyConnect.com, pois o texto é renderizado por meio de chamadas de serviço da web)
• Texto para fala (através do navegador web)

• Texto para fala (através da câmera)
• Ativar Encode Adaptativo ao (outro dispositivo)
• Ativar Alerta ao (outro dispositivo)
• Ativar Ask AI (outro dispositivo)
• Ativar Reconhecimento de Áudio (outro dispositivo)
• Ativar detecção ao (outro dispositivo)
• Ativar reconhecimento facial (outro dispositivo)
• Ativar LPR (outro dispositivo)
• Ativar reconhecimento de objeto (outro dispositivo)
• Ativar gravação (com tempo limite) (outro dispositivo). Isto gravará até a configuração de tempo limite de gravação ativada na aba Gravação. Este tempo limite é reiniciado a cada chamada de ação de gravação ativada.
• UI: Alterar visualização - alternar as UIs conectadas para uma visualização diferente

As etiquetas nos campos Então das ações do Agent DVR permitem que você crie respostas dinâmicas. É importante observar que algumas etiquetas são específicas do contexto. Por exemplo, {FILENAME} não está disponível para Eventos de Alertas, e {AI} não está disponível se o evento não foi gerado por um Servidor de IA.

• {ID}: A ID do objeto, visível no Canto superior esquerdo do editor ao editar uma Câmera ou Microfone no Agent.
• {OT}: A ID do tipo de objeto. 1 para Microfone, 2 para Câmera.
• {FILENAME}: O Nome do arquivo. Aplicável a eventos como Gravação iniciada, Gravação finalizada e Instantâneo tirado. É 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, "Alerta Manual".
• {EVENT}: O tipo de evento.
• {NAME}: O nome do Dispositivo (encontrado na aba Geral).
• {GROUPS}: Os Grupos aos quais o Dispositivo pertence (encontrados na aba Geral).
• {SERVER}: O nome do Servidor (das Configurações do servidor).
• {ALERTID}: A ID do Alerta (-1 se não houver um 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 etiquetas associadas ao evento.
• {PLUGIN}: A Mensagem de um Evento de Plugin.

• {LOCATION}: A Localização da Câmera (encontrada na aba Geral).
• {LEVEL} e {DB}: O Nível de áudio ou movimento. {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írgulas de Objetos detectados da IA, placas do LPR, ou rostos detectados do Reconhecimento Facial.
• {AIJSON}: Dados JSON retornados da IA ou LPR.
• {ZONE}: A zona que acionou a Ação (vazia se não estiver usando IA ou uma lista CSV para múltiplas zonas como 1,2,3).
• {BASE64IMAGE}: URL de dados de imagem ao vivo. São bytes codificados em base64 bruto, portanto formate conforme necessário, por exemplo:

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

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

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

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

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

  (Disponível v6.0.8.0+). Imagem ao vivo nativa.
• {TRIPCOUNT}, {TRIPCOUNTLEFT} e {TRIPCOUNTRIGHT}: Os contadores de cruzamento de fio sensível (total, esquerda e direita) somados em todos os fios sensíveis na câmera. 0 se a câmera não estiver usando o detector de fio sensível. (v7.7.4.0+)
• {TRIPJSON}: Os contadores de fio sensível como JSON com um detalhamento por fio, por exemplo

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

  (v7.7.4.0+)

Por exemplo, com um evento IA: Rosto reconhecido, uma tarefa Então Texto para fala com o texto

Olá {AI}

Observação: Se você usar etiquetas {BASE64IMAGE} com um evento relacionado a arquivo como "Foto tirada", ele usará a imagem em tamanho completo do arquivo. Caso contrário, ele redimensionará a imagem da 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 Agendador para ativar/desativar Ações ou acionar uma Ação. Por exemplo, você pode agendar uma Ação para enviar um email com duas Imagens em uma hora específica.

Neste exemplo, uma Ação foi adicionada para enviar um email com 2 Imagens, definida para evento Nenhum. Em seguida, uma Entrada de agendamento foi criada para executar essa Ação às 8h nos domingos e sábados.