Pular para o conteúdo principal

Hikvision LPR - Logs de Imagens

O plugin Hikvision LPR - logs de imagens armazena no ACCELERO as imagens de placas capturadas por dispositivos LPR Hikvision (reconhecimento de placas veiculares) e disponibiliza uma tela de pesquisa dessas fotos. Cada captura é guardada com a placa lida, a qualidade do reconhecimento, o dispositivo de origem e a data/hora.

Disponibilidade

Esta funcionalidade é disponibilizada como plugin (hikvision_lpr_picturesaver) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.

Compatibilidade

Versão atual do plugin: 0.0.5 — compatível com ACCELERO 2.16.4 ou superior.

Pré-requisito

O plugin trabalha em cima dos dispositivos LPR Hikvision já cadastrados no ACCELERO. Veja Integração Hikvision para o cadastro dos equipamentos.


O que o plugin faz

FuncionalidadeO que acontece no ACCELERO
Armazenamento de fotos LPRAs imagens enviadas pelos dispositivos LPR Hikvision são recebidas via MQTT e gravadas em disco no servidor, junto com placa, qualidade e data/hora
Pesquisa de fotosUma tela dedicada (Fotos LPR Hikvision) permite filtrar as capturas por data, dispositivo e placa, exibindo a imagem
Controle de quotaDefine-se uma quota de armazenamento (em MB); o sistema acompanha o uso atual
Limpeza automática (FIFO)Quando a quota é atingida, as imagens mais antigas são removidas automaticamente a cada nova captura
Limpeza manualUm botão na tela de configuração executa a limpeza de armazenamento sob demanda
Exclusão de fotosExclusão individual ou em lote pela tela de pesquisa, removendo o registro e o arquivo de imagem
Benefício principal

Mantém um histórico pesquisável das placas capturadas pelas câmeras LPR Hikvision, com controle de espaço em disco para evitar o crescimento ilimitado do armazenamento.


Habilitar o armazenamento por dispositivo

O envio das fotos é configurado em cada dispositivo LPR Hikvision. Na edição do dispositivo, o plugin adiciona o campo:

CampoDescrição
Armazenar fotos LPRChave liga/desliga. Quando ativada, as imagens capturadas por esse dispositivo passam a ser encaminhadas e armazenadas no ACCELERO
TODO: Adicionar Screenshot

Tela de edição do dispositivo LPR Hikvision com a chave Armazenar fotos LPR adicionada pelo plugin.

Apenas dispositivos com a chave ativa

Somente os dispositivos com Armazenar fotos LPR ativado encaminham imagens para armazenamento. Dispositivos com a chave desligada continuam operando normalmente no controle de acesso, mas suas capturas não são guardadas por este plugin.


Configuração

Caminho de acesso: Configurações > Integrações - Hikvision - Fotos LPR

A tela de configuração possui uma única aba, Geral.

Tela de configuração da integração Hikvision - LPR - Fotos

TODO: Adicionar Screenshot

Aba Geral da tela Configurações > Integrações - Hikvision - Fotos LPR, mostrando os campos Quota de armazenamento e Quota de armazenamento (uso) e o botão Realizar limpeza agora.

CampoDescrição
Quota de armazenamentoLimite de armazenamento das fotos, em MB. Campo obrigatório. Valor padrão na instalação: 10
Quota de armazenamento (uso)Espaço atualmente ocupado pelas imagens armazenadas (somente leitura)

Botões da tela

BotãoFunção
Realizar limpeza agoraExecuta a limpeza de armazenamento sob demanda, removendo as imagens mais antigas até respeitar a quota. Exige confirmação
SalvarPersiste a quota de armazenamento configurada
VoltarRetorna à listagem de configurações
A limpeza é irreversível

Realizar limpeza agora apaga arquivos de imagem do disco. A ação é registrada no log de auditoria do sistema com a quantidade de arquivos excluídos.


Tela de Fotos LPR Hikvision

Caminho: Menu lateral > Configurações > Fotos LPR Hikvision

Lista todas as capturas armazenadas, com filtros de pesquisa e visualização da imagem.

Tela de listagem de Fotos LPR Hikvision

TODO: Adicionar Screenshot

Tela Fotos LPR Hikvision mostrando a listagem com as colunas (data/hora, dispositivo, qualidade, placa, foto) e o painel de pesquisa aberto.

Filtros de pesquisa

FiltroDescrição
Data inicial / Data finalRecorte por data/hora da captura
Dispositivo LPR HikvisionMulti-seleção dos dispositivos LPR de origem
PlacaBusca textual pela placa lida

Colunas

ColunaConteúdo
Data/horaMomento da captura (ordenação padrão: mais recentes primeiro)
Dispositivo LPR HikvisionDispositivo que gerou a captura (N/A quando não identificado)
QualidadeÍndice de confiança do reconhecimento informado pela câmera
PlacaPlaca lida pelo dispositivo
FotoMiniatura da imagem capturada

Ações

AçãoFunção
Excluir (linha / seleção)Remove os registros selecionados e seus arquivos de imagem. Disponível em lote pelo menu Mais ações > Excluir

Como as fotos chegam ao ACCELERO

O dispositivo LPR Hikvision publica cada captura em um tópico MQTT (.../hikvision/lpr/<dispositivo>/photoforward). O plugin escuta esse tópico e, para cada mensagem, espera os campos:

Campo da mensagemVai para
timestampData/hora da captura
licenseplatePlaca
confidenceQualidade (confiança)
photoImagem da placa (codificada em base64)

O plugin grava o registro no banco e salva a imagem como arquivo .jpg no servidor. Em seguida, executa a rotina de limpeza de armazenamento para manter o uso dentro da quota.

Mensagens incompletas são descartadas

Se a mensagem recebida não trouxer dispositivo, data/hora, placa, qualidade ou imagem, a captura é ignorada e o motivo é registrado no log de depuração do plugin.


Limpeza e controle de espaço

O plugin mantém o uso de disco dentro da Quota de armazenamento configurada por meio de uma estratégia FIFO (as imagens mais antigas são as primeiras a serem removidas):

  • Automática: a cada nova foto recebida, o plugin verifica o uso e, se a quota estiver excedida, remove as imagens mais antigas até voltar ao limite.
  • Manual: o botão Realizar limpeza agora, na tela de configuração, dispara a mesma rotina sob demanda.
Dimensione a quota com folga

Imagens LPR podem se acumular rapidamente em ambientes de alto fluxo. Defina a Quota de armazenamento considerando o volume diário de capturas e o período de histórico que você precisa manter pesquisável.


Permissões

O plugin cria permissões dedicadas, atribuíveis aos Perfis de operador:

PermissãoO que libera
Hikvision - monitorar fotos LPRAcessar e pesquisar a tela Fotos LPR Hikvision
Hikvision - excluir fotos LPRExcluir fotos (individual ou em lote)
Hikvision - Limpar fotos LPRExecutar a limpeza de armazenamento

Casos de uso

Habilitar o armazenamento de fotos LPR

  1. Solicitar à IONGRADE a instalação do plugin hikvision_lpr_picturesaver.
  2. Em cada dispositivo LPR Hikvision desejado, ativar a chave Armazenar fotos LPR e salvar.
  3. Em Configurações > Integrações - Hikvision - Fotos LPR, definir a Quota de armazenamento (MB) e salvar.
  4. Atribuir as permissões de monitoramento aos perfis de operador que devem consultar as fotos.
  5. Acompanhar a tela Fotos LPR Hikvision para confirmar que as capturas estão chegando.

Pesquisar a foto de uma placa

  1. Acessar Fotos LPR Hikvision.
  2. Abrir a pesquisa e informar a Placa e/ou o intervalo de Data inicial / Data final.
  3. Opcionalmente filtrar pelo Dispositivo LPR Hikvision.
  4. Visualizar a imagem na coluna Foto.

Liberar espaço em disco

  1. Verificar o campo Quota de armazenamento (uso) na tela de configuração.
  2. Se necessário, ajustar a Quota de armazenamento e salvar.
  3. Clicar em Realizar limpeza agora e confirmar para remover as imagens mais antigas excedentes.

Boas práticas

  • Ative só onde necessário: habilite Armazenar fotos LPR apenas nos dispositivos cujas capturas você realmente precisa guardar, evitando ocupar disco com imagens irrelevantes.
  • Quota compatível com o disco: defina a quota dentro do espaço disponível no servidor ACCELERO, com margem de segurança.
  • Permissões restritas: conceda Hikvision - excluir fotos LPR e Hikvision - Limpar fotos LPR apenas a operadores de confiança, pois ambas removem dados permanentemente.

Troubleshooting

Fotos não aparecem na listagem

Possíveis causas:

  • Chave Armazenar fotos LPR desativada no dispositivo
  • Dispositivo não está publicando as capturas via MQTT
  • Mensagens chegando incompletas (sem placa, imagem, etc.)

Solução:

  1. Confirme que Armazenar fotos LPR está ativado na edição do dispositivo.
  2. Verifique a comunicação MQTT entre o dispositivo e o ACCELERO.
  3. Em caso de persistência, contate o suporte IONGRADE com a referência do dispositivo.

Imagem não carrega (foto indisponível)

Possíveis causas:

  • O arquivo de imagem foi removido pela rotina de limpeza ou exclusão
  • Registro existe, mas o arquivo .jpg não está mais no disco

Solução:

  • Quando o arquivo não é encontrado, o sistema exibe uma imagem padrão de "sem foto". Capturas antigas podem ter sido removidas pela limpeza FIFO ao atingir a quota.

Uso de armazenamento sempre alto

Possíveis causas:

  • Quota de armazenamento subdimensionada para o volume de capturas
  • Muitos dispositivos com Armazenar fotos LPR ativado

Solução:

  1. Reavalie a Quota de armazenamento na tela de configuração.
  2. Desative o armazenamento nos dispositivos que não exigem histórico de imagem.
  3. Use Realizar limpeza agora para liberar espaço imediatamente.

Integração com outros módulos

Dispositivos Hikvision

O plugin estende os dispositivos LPR Hikvision com a chave Armazenar fotos LPR. Consulte Integração Hikvision para o cadastro e a operação desses equipamentos.

Perfis e Operadores

O acesso às telas e ações do plugin é controlado pelas permissões atribuídas aos Perfis dos Operadores.

Veículos

As capturas registram a placa lida pelas câmeras, podendo apoiar a conferência de acessos veiculares geridos em Veículos.


Próximos Passos

  • Integração Hikvision — Cadastro e operação dos dispositivos LPR Hikvision
  • Perfis — Configure as permissões de acesso às fotos LPR
  • Veículos — Cadastro de veículos e placas no ACCELERO
  • Plugins — Saiba mais sobre o sistema de plugins do ACCELERO