Como configurar o servidor de alarme na câmera VIGI

Conteúdo

Introdução

Requisitos

Configuração

Verificação

Conclusão

Perguntas e Respostas

Introdução

O recurso Servidor de Alarmes foi desenvolvido para receber mensagens de eventos reportadas proativamente pelas Câmeras VIGI e pelos NVRs VIGI quando eventos de alarme são acionados.

As informações incluídas no relatório serão gradualmente ampliadas conforme a versão do software do dispositivo for atualizada, incluindo o tipo de evento, o horário do evento, os detalhes do dispositivo e uma imagem opcional capturada no momento do evento.

Esse recurso permite a integração contínua de alarmes e o processamento de eventos entre dispositivos VIGI e sistemas de terceiros.

Além de descrever como configurar a função Servidor de Alarmes nos dispositivos VIGI, este artigo também fornece orientações para solução de possíveis problemas, como falhas de conexão com o servidor, dados do dispositivo reportados de forma anormal e erros de processamento no servidor.

Requisitos

• Câmera/NVR VIGI
• Servidor de Alarmes
• Notebook

Configuração

Como o formato das mensagens e o processo de análise utilizados durante a comunicação entre as Câmeras VIGI e os NVRs VIGI são idênticos, este artigo utiliza uma Câmera VIGI como exemplo para demonstração.

Etapa 1. Monte a topologia de acordo com o diagrama de topologia abaixo.

Observação: A topologia apresentada neste artigo é apenas para referência. Os cenários reais de implantação podem ser mais diversos.

Etapa 2. Acesse a interface web da Câmera VIGI usando seu endereço IP. Digite o Nome de usuário e a Senha e clique em Login.

Etapa 3. Acesse Configurações > Evento > Servidor de Alarmes e clique no botão “+Adicionar”.

Etapa 4. Na janela pop-up, insira as informações relacionadas ao servidor de terceiros. Neste artigo, o https://webhook.site/#!/ é utilizado como servidor de referência.

Etapa 5. Insira o IP do Host ou Domínio e a URL do servidor de terceiros, selecione o protocolo apropriado (HTTP ou HTTPS) e especifique o número da porta correspondente (porta 80 para HTTP e porta 443 para HTTPS). Neste artigo, o protocolo HTTP e a porta 80 são utilizados como exemplo de configuração. Você também pode escolher se deseja incluir uma imagem anexada na mensagem de evento reportada. Por fim, clique em Salvar para aplicar e armazenar a configuração.

Observação:
1. Nos parâmetros de configuração, IP do Host/Domínio refere-se ao endereço IP ou nome de domínio do servidor, que neste artigo é o webhook.site.

2. A URL corresponde ao caminho da URL utilizado nas mensagens HTTP trocadas entre o dispositivo e o servidor. Neste documento, é utilizada a URL padrão do servidor (/e499f73b-b773-4721-b6a1-544a8efaef34).

3. O Serviço de Mensagens de Alarme Aprimoradas é compatível após atualizações de firmware das IPCs e dos NVRs. Após ativar essa função, o Servidor de Alarmes poderá incluir informações mais detalhadas sobre os alarmes nas mensagens reportadas, como campos aprimorados relacionados ao evento ou atributos adicionais do evento. Isso ajuda as plataformas de terceiros a obter informações de alarme mais completas para processamento posterior.

Observe que, após ativar essa função, o formato das mensagens de alarme pode ser diferente do formato anterior. Portanto, se o seu servidor de terceiros já tiver implementado uma lógica de análise das mensagens de alarme, talvez seja necessário ajustar as respectivas regras de análise.

Para conferir as diferenças no formato das mensagens de alarme antes e depois de ativar essa opção, consulte a segunda pergunta e resposta na seção Perguntas e Respostas.

Etapa 6. Você pode clicar no botão “Testar” para verificar o status da conexão entre o dispositivo e o servidor.

Etapa 7. Quando uma mensagem pop-up exibir “O serviço está disponível”, isso indica que o status da conexão está normal e que a função está operando corretamente. Clique em OK para continuar.

Etapa 8. Acesse Configurações > Evento > Evento Inteligente > Detecção de Pessoas e ative a função de detecção de pessoas.

Observação: Este artigo utiliza a Detecção de Pessoas como exemplo para demonstração. As outras funções de detecção de eventos também funcionarão da mesma maneira.

Etapa 9. Em modo de processamento, selecione a opção “Enviar para o Servidor de Alarmes”. Por fim, clique em Aplicar.

Verificação

Etapa 1. Configure o espelhamento de portas no switch para espelhar a porta conectada à câmera VIGI para a porta conectada ao notebook. Inicie a captura de pacotes na interface de rede do notebook usando o Wireshark e, em seguida, acione o evento de Detecção de Pessoas.

Etapa 2. Verifique as informações reportadas pela Câmera VIGI.

Cenário 1. Sem imagem anexada

Etapa 1. Use o comando “http” para filtrar os pacotes capturados. Em seguida, verifique a Solicitação HTTP POST e a Resposta HTTP.

Etapa 2. Verifique os Cabeçalhos da Solicitação HTTP POST.

Observação: A primeira linha contém o método POST, o URI de destino da solicitação e a versão HTTP 1.1. O URI corresponde à string da URL configurada anteriormente nas configurações do Servidor de Alarmes.

Da segunda linha até a linha em branco, cada linha representa um par chave-valor que descreve os metadados da solicitação. Esses dados incluem Host, Content-Type, Content-Length e Cache-Control.

Quando o Content-Type está definido como application/json, isso indica que somente a mensagem do evento é enviada (sem imagem anexada) e que o corpo da solicitação é uma string formatada em JSON.

Cada linha termina com \r\n. Uma linha em branco composta apenas por \r\n indica o fim dos cabeçalhos da solicitação e o início do corpo da solicitação.

Etapa 3. Verifique o Corpo da Solicitação HTTP POST.

Observação: No payload JSON, ip representa o endereço IP da IPC que reporta a mensagem de evento, e MAC representa o endereço MAC da IPC que está reportando o evento. O campo protocol indica se a comunicação utiliza o protocolo HTTP ou HTTPS. O campo device_name especifica o nome da IPC que está reportando o evento.

Dentro de event_list, cada entrada representa um evento incluído no relatório, indicando o horário de ocorrência do evento e o nome do evento correspondente.

Etapa 4. Verifique a Resposta HTTP. Um código de status 200 OK retornado indica que o servidor webhook.site recebeu e processou a solicitação com sucesso.

Etapa 5. Compare os dados reportados no corpo da Solicitação HTTP POST com os dados recebidos e analisados pelo servidor webhook.site para verificar se são consistentes.

Cenário 2. Com imagem anexada

Etapa 1. Antes de iniciar a captura de pacotes, clique no botão Editar no canto superior direito da página do servidor webhook.site e altere o Content-Type das mensagens com imagens anexadas para multipart/form-data; boundary=ReportEventBoundary.

Observação: multipart/form-data indica dados mistos contendo uma string JSON e dados de imagem. boundary=ReportEventBoundary especifica o limite utilizado para separar as diferentes partes do payload de dados.

Etapa 2. Use o comando “http” para filtrar os pacotes capturados. Em seguida, verifique os Cabeçalhos e o Corpo da Solicitação HTTP POST.

Observação: O corpo da solicitação começa após uma linha em branco (\r\n). Como o Content-Type é multipart/form-data, o corpo é dividido em várias partes, cada uma separada pelo limite --ReportEventBoundary. O corpo da solicitação termina com --ReportEventBoundary--.

A primeira parte contém os dados JSON do evento e a segunda parte contém os dados da imagem JPEG. O campo name indica o horário da imagem, image/jpeg especifica que essa parte contém dados de imagem JPEG e Content-Length indica o tamanho dos dados da imagem.

JPEG DATA representa o conteúdo binário da imagem JPEG.

Etapa 3. Verifique a Resposta HTTP. Um código de status 200 OK retornado indica que o servidor webhook.site recebeu e processou a solicitação com sucesso.

Etapa 4. Compare os dados reportados no corpo da Solicitação HTTP POST com os dados recebidos e analisados pelo servidor webhook.site para verificar se são consistentes.

Observação: O próprio servidor webhook.site não analisa nem decodifica o conteúdo da imagem enviada. Ele apenas recebe e exibe os dados da solicitação HTTP. Portanto, somente as informações do evento e o horário correspondente da imagem ficam visíveis.

Conclusão

Você configurou com sucesso o recurso Servidor de Alarmes e, quando um evento é acionado, a mensagem do evento e a imagem capturada são reportadas com sucesso.

Para saber mais sobre cada função e configuração, acesse a Central de Suporte para baixar ou consultar o manual do seu produto.

Perguntas e Respostas

P1: Se o Servidor de Alarmes foi configurado com sucesso, mas nenhum dado de alarme é recebido pelo servidor quando um evento é acionado, o que devo fazer?

R1: Realize as seguintes verificações:

Etapa 1. Faça uma verificação preliminar da configuração. Consulte os logs do dispositivo para confirmar se o evento foi realmente detectado e acionado e se a opção Enviar para o Servidor de Alarmes está ativada nas configurações. Ao mesmo tempo, verifique todos os parâmetros de configuração do Servidor de Alarmes no dispositivo, prestando atenção especial para confirmar se a porta configurada está sendo efetivamente monitorada pelo servidor e se a URL corresponde exatamente ao endpoint de escuta do servidor.

Etapa 2. Configure o espelhamento de portas e capture os pacotes do lado do dispositivo. Em seguida, verifique os seguintes itens sequencialmente:

• Conexão TCP: Verifique se o handshake de três vias do TCP entre o dispositivo e o servidor foi estabelecido com sucesso.
• Solicitação HTTP POST: Confirme se a solicitação POST foi iniciada com sucesso e se o formato do cabeçalho da solicitação está correto. Preste atenção especial ao campo Content-Type. Quando apenas as informações do evento são reportadas, o Content-Type deve ser application/json. Quando uma imagem capturada é incluída, o Content-Type deve ser multipart/form-data, e os dados mistos (string JSON e dados da imagem) devem ser separados usando boundary=ReportEventBoundary.
• Resposta HTTP: Verifique o código de status da resposta HTTP retornado no pacote para confirmar se o servidor responde corretamente à solicitação HTTP.

P2: Qual é a diferença no formato da mensagem de alarme antes e depois de ativar o Serviço de Mensagens de Alarme Aprimoradas?

R2: Depois que o Serviço de Mensagens de Alarme Aprimoradas é ativado, o formato das mensagens do Servidor de Alarmes é otimizado para incluir informações de alarme mais detalhadas. Se o seu servidor de terceiros já tiver implementado uma lógica de análise de mensagens de alarme baseada no formato anterior, verifique e modifique a lógica de análise conforme necessário.

1. Para IPC VIGI, as principais diferenças são as seguintes:
(1) Otimização do cabeçalho da mensagem
Após a ativação do Serviço de Mensagens de Alarme Aprimoradas, o campo filename é adicionado ao multipart/form-data. Esse campo é usado para identificar o nome do arquivo da imagem capturada enviada com a mensagem de alarme, melhorando a compatibilidade com servidores de terceiros durante a análise e o salvamento das imagens de alarme.
(2) Otimização do corpo da mensagem

Após a ativação do Serviço de Mensagens de Alarme Aprimoradas, as informações básicas do dispositivo na mensagem de alarme, incluindo ip, mac, protocol e device_name, permanecem inalteradas. A principal otimização está na estrutura de event_list: cada evento agora é descrito como um objeto de evento independente e são adicionadas informações de alarme mais detalhadas, como a câmera/canal acionado, horário do evento, informações da região ou linha, direção do cruzamento de linha, número do objeto e coordenadas da posição do objeto. Consulte a tabela abaixo para obter mais detalhes.
Antes de ativar o Serviço de Mensagens de Alarme Aprimoradas:

Após ativar o Serviço de Mensagens de Alarme Aprimoradas:

2. Para o NVR VIGI, após a ativação do Serviço de Mensagens de Alarme Aprimoradas, o formato das mensagens do Servidor de Alarmes é otimizado principalmente por meio do ajuste dos nomes dos campos, tornando as informações de alarme mais claras e fáceis de entender. O formato otimizado adiciona o campo Extra Text, reservado para informações de alarme estendidas. Consulte a tabela abaixo para obter mais detalhes.

Antes de ativar o Serviço de Mensagens de Alarme Aprimoradas:

Após ativar o Serviço de Mensagens de Alarme Aprimoradas: