Integração com driver Hikvision

1. Efetue um cadastro na tela de drivers e selecione o item "SDK" no campo Tipo do driver;
2. Em seguida, para baixá-lo, acesse a tela Downloads;
3. Depois que o driver estiver descompactado, o arquivo updater.properties deve ser ajustado. Nesse arquivo, configure a propriedade updater.java_home_env apontando para uma variável de ambiente que possua o caminho do Java 8. Exemplo: updater.java_home_env=JAVA_HOME;
4. Para instalar o Driver como serviço, execute o arquivo create-service.bat como Administrador através do prompt de comando, depois verifique se o serviço do driver foi criado nos Serviços do Windows.
5. O driver pode ser iniciado e parado através dos Serviços do Windows;
6. A configuração do driver é feita no arquivo config.properties, que fica no diretório onde o driver foi descompactado.

sdk.host

Endereço de acesso ao Ronda Senior X seguido da porta e outros parâmetros.

sdk.api_key

Token gerado para este driver na tela de cadastro de drivers.

sdk.connection.timeout

Tempo máximo, em milissegundos, pelo qual o driver Hikvision irá esperar pela resposta de uma placa antes de considerá-la off-line.

sdk.request.timeout

Intervalo de tempo, em milissegundos, no qual o driver Hikvision fará a busca de eventos em cada placa.

sdk.api_response.timeout

Tempo mínimo de espera da resposta da API SDK (resposta do comando enviado para o dispositivo).

sdk.websocket.pendency.host

Endereço de conexão do WebSocket utilizado no processamento de pendências. Por padrão, está configurado para o Ronda Senior X. Este parâmetro vem oculto no config.properties, mas pode ser configurado manualmente quando necessário.

device.pendency.include_or_exclude.sleep.ms

Tempo de espera, em milissegundos, aplicado no processamento de pendências dos tipos include e exclude. Por padrão, este parâmetro está configurado com o valor 500. Este parâmetro vem oculto no config.properties, mas pode ser alterado manualmente quando necessário.

1. Na Senior X, acesse Gestão de Riscos e Segurança > Controle de acesso > Propriedades extensíveis;
2. Cadastre um novo Grupo de propriedades extensíveis, para informar o usuário e a senha do dispositivo;
3. Nesse grupo, cadastre duas propriedades extensíveis: username, para informar o usuário de acesso ao dispositivo, e password, para informar a senha.

1. Na Senior X, acesse Gestão de Riscos e Segurança > Controle de acesso > Dispositivos;
2. Cadastre um dispositivo gerenciador do tipo Controle de acesso, informando o driver cadastrado anteriormente;
3. Informe o endereço do dispositivo e a porta de comunicação. Normalmente, a porta padrão desses dispositivos é 80;
4. No campo Propriedades extensíveis, selecione a propriedade cadastrada anteriormente;
5. Na seção Acessos monitorados, indique quais tipos de acesso devem gerar ocorrências, os tipos de ocorrências e se devem disparar e-mail;

Observação

Embora seja possível configurar a geração de ocorrências por detecção de temperatura irregular e ausência de máscara, a configuração do bloqueio de acesso é realizada diretamente no display do dispositivo.

6. Preencha os demais campos obrigatórios e clique em Salvar.

Observação

Esse dispositivo precisa pertencer a um Driver SDK.

7. Abaixo do dispositivo gerenciador (na hierarquia do dispositivo), cadastre:
• uma leitora biométrica, com biometria do tipo facial;
• uma leitora de credenciais, de acordo com a tecnologia de crachás utilizada nos cadastros de credenciais das pessoas, como Smart Card, por exemplo.

Otimização de carga e sincronismo facial

As seguintes propriedades extensíveis permitem otimizar o desempenho da carga inicial e dos sincronismos de fotos e dados entre a Concentradora e o dispositivo Hikvision:

Propriedade	Padrão	Faixa/Valores	O que controla
uploadConcurrency	1	1 a 5	Quantidade de pessoas enviadas simultaneamente ao equipamento durante a carga e sincronismo facial. Aumentar este valor melhora a performance em equipamentos com muitas pessoas, mas requer avaliar a carga na rede e no equipamento.
enableFaceSync	false	true ou false	Ativa o sincronismo facial automático do dispositivo. Quando ligado, o equipamento sincroniza automaticamente no horário definido em faceSyncTime.
faceSyncTime	02:00	Horário em formato HH:mm	Horário do sincronismo facial automático, utilizando o horário do servidor da Concentradora. Use sempre horários cheios (ex: 02:00, 03:00), nunca com minutos diferentes.
maxRetries	2	Número inteiro ≥ 0	Quantidade de tentativas para reenviar o cartão ou a face quando o equipamento responde que a pessoa não existe. Valor 0 desativa as repetições.
retryDelay	300	Milissegundos; 0 ou negativo usa 300	Tempo de espera (em ms) antes da primeira repetição. A espera dobra a cada nova tentativa. Cuidado com valores altos: podem segurar a execução.

Comportamento do sincronismo automático

• Quando um dispositivo Hikvision é carregado sem as propriedades enableFaceSync e faceSyncTime, o driver as cria automaticamente com valores padrão (false e 02:00). Para ativar o sincronismo, altere enableFaceSync para true.
• A Concentradora verifica os dispositivos a cada hora e sincroniza automaticamente os que estão com enableFaceSync = true, online e com o datamart carregado, quando a conferência cai a até 30 minutos do faceSyncTime.
• Use horários cheios em todos os dispositivos (ex: 01:00, 02:00, 03:00). A conferência de hora em hora segue o minuto do horário mais próximo quando a Concentradora inicia. Com minutos diferentes, o sincronismo pode sair até 30 minutos antes ou depois do horário planejado, e uma diferença de exatamente 30 minutos (ex: 02:00 e 02:30) faz um dos dispositivos sincronizar duas vezes na mesma noite.
• Se o dispositivo estiver offline ou sem o datamart carregado no horário agendado, o sincronismo daquele dia não ocorre; o próximo sincronismo será no mesmo horário do dia seguinte.
• Dispositivos com o mesmo faceSyncTime começam com 2 segundos de intervalo entre eles. Para distribuir o trabalho da rede, especialmente com uploadConcurrency alto, configure horários cheios diferentes para cada dispositivo.
• Se o horário for inválido (ex: 2:00, 25:00, texto), será registrado um erro no log da Concentradora a cada conferência, e o dispositivo não sincronizará automaticamente até a correção.
• A Concentradora relê as propriedades enableFaceSync e faceSyncTime a cada conferência; alterações entram em vigor na conferência seguinte.

Sincronismo manual

Existem duas opções de sincronismo manual que ignoram as configurações de agendamento automático:

• Requisitar Sincronismo Facial: na tela inicial do console da Concentradora, roda em todos os dispositivos Hikvision e Intelbras online.
• Forçar Sincronismo Facial: no detalhe do dispositivo, roda apenas no dispositivo selecionado.

Repetição do envio (Hikvision)

Alguns modelos de Hikvision podem recusar temporariamente o cartão ou a face após o cadastro de uma pessoa, indicando que ela não existe (employeeNoNotExist). O driver gerencia essas recusas automaticamente:

• Quando uma recusa é detectada, o driver verifica se a pessoa está realmente no equipamento.
• Se não estiver, o cadastro é refeito e o envio é retentado.
• Se estiver, aguarda o tempo definido em retryDelay e repete o envio, dobrando a espera a cada tentativa.
• As repetições acontecem na carga facial, no sincronismo e na atualização de dados de uma pessoa.
• Com os valores padrão (maxRetries = 2, retryDelay = 300 ms), são até 3 tentativas, com esperas de 300 ms e 600 ms quando a pessoa já existe no equipamento.
• Valores não numéricos são registrados no log do driver e o sistema usa o padrão. maxRetries com valor 0 ou negativo desativa completamente as repetições.
• Cuidado com valores altos: como a espera dobra, maxRetries = 5 com retryDelay = 300 pode segurar uma pessoa por até 9,3 s no cartão e novamente na face.
• As propriedades maxRetries e retryDelay são lidas quando a configuração do equipamento é carregada.

Valores inválidos

• Valor ausente em uploadConcurrency, maxRetries ou retryDelay usa o padrão.
• Valor fora da faixa (ex: uploadConcurrency > 5 ou < 1) registra um erro no log do driver e usa o padrão.
• Cada carga ou sincronismo usa o valor de uploadConcurrency vigente quando a operação começa; alterações durante a execução não afetam a operação em andamento.

Algumas configurações devem ser realizadas na tela do dispositivo Hikvision:

• Grau de conferência da face: ele deve ser ajustado para o ambiente em que o dispositivo se encontra e de acordo com a base de fotos do cliente;
• Faixa normal de temperatura: é preciso configurar qual é a temperatura mínima e máxima que serão consideradas normais, pois quando o driver receber do dispositivo um evento indicando temperatura anormal, ele irá gerar um acesso negado por temperatura anormal e o enviará ao sistema.

• Configuração para detecção de máscara: caso a opção Face with Mask Detection esteja marcada, o Driver notificará os eventos de pessoa com e sem máscara. É recomendado que essa opção fique desmarcada quando o monitoramento de máscaras não estiver sendo utilizado. Essa configuração também está presente através da web console da Hikvision, em Configuration > Smart > Face with Mask Detection.

• Ação após identificar pessoa sem máscara: deve-se configurar a ação que será realizada após identificado que uma pessoa está sem máscara. Caso seja configurado para não abrir a porta ("tipsAndNotOpenDoor"), o driver irá gerar um acesso negado sem máscara e o enviará ao sistema.

Durante a entrega da credencial, a pessoa deve possuir uma foto cadastrada para carregar no dispositivo. Recomendamos as seguintes especificações:

• Tamanho: 60 kB a 200 kB;
• Resolução Mínima: 640 x 480 pixels;
• Formato: JPG ou JPEG.

O comando Carga de lista de liberação deve ser realizado depois que o driver estiver comunicando com os dispositivos, para fazer a carga inicial das pessoas, com suas credenciais e fotos que serão utilizadas no reconhecimento facial.

Na Senior X, acesse Gestão de Riscos e Segurança > Controle de acesso > Dispositivos.

Então, selecione o gerenciador da Hikvision e, na seção Envio de Comando, clique em Enviar comando, selecione a Carga de lista de liberação e clique em Enviar comando.

A consulta de eventos de acesso dos dispositivos Hikvision exibe informações sobre o uso de máscara e temperatura da pessoa no momento do acesso. Esses detalhes devem estar disponíveis e habilitados na configuração da tela do dispositivo.

Para consultar esses eventos, acesse a Senior X > Customização > Relatórios > Visões dinâmicas, tabela sam-evento-pessoa.

Os procedimentos efetuados pelo driver Hikivision são registrados em arquivos de log, que podem ser acessados dentro da pasta onde o driver está instalado. Cada mensagem do log possui uma classificação dentre as seguintes:

• FATAL: mensagens que interrompem o funcionamento da aplicação, forçando o serviço ou o executável a ser reiniciado;
• ERROR: mensagens de mal funcionamento da aplicação, que deve ser analisada pela equipe técnica da Senior, porém o serviço ou o executável continua executando;
• WARN: mensagens que indicam falha em cadastros ou nas configurações do sistema. Devem ser analisadas pelo administrador do sistema;
• INFO: mensagens de funcionamento normal do sistema (exemplos: evento recebido, pendência enviada etc.) para efeitos informativos;
• DEBUG: mensagens de funcionamento interno de componentes do sistema (exemplos: timer iniciado, parâmetros lidos etc.) para efeitos informativos à equipe técnica da Senior. Esse nível de log deve ser habilitado somente em caso de problemas com o ambiente;
• TRACE: mensagens de funcionamento interno de componentes do sistema, com detalhes dos dados que estão sendo tratados.