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).

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.

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.