Solavel Documentos
Português

Configuração do SDK do fabricante (ZKTeco)

Última atualização

A maioria dos terminais é lida diretamente pela rede e não precisa de mais nada. Alguns tipos de conexão usam o software próprio do fabricante para Windows (um "SDK") no PC do conector. Hoje isso vale apenas para o SDK da ZKTeco. Esta página explica quando você precisa dele, como instalá-lo passo a passo, o que significam as verificações e as regras de licença.

Nota de pré-visualização e transparência. O caminho do SDK foi construído e verificado apenas com simulações de software. Ele não foi executado com uma instalação real do SDK em um PC com Windows, nem em terminais reais de todos os modelos. Detalhes que podem variar em um PC real: a estrutura do registro, o comportamento de regsvr32 e as respostas exatas do SDK a algumas chamadas. Experimente primeiro em um dispositivo. Se não funcionar, a conexão direta integrada sempre está disponível.

#Você precisa dele?

Provavelmente não. Para a maioria dos terminais ZKTeco, escolha ZKTeco (direto): ele lê marcações e usuários, acerta o relógio, reinicia o dispositivo e edita usuários, e foi verificado em um iFace702 real. Use o tipo SDK somente se precisar do que o direto não faz:

Recurso ZKTeco direto SDK da ZKTeco
Ler marcações, usuários e o relógio do dispositivo Sim Sim
Editar, adicionar e excluir usuários; acertar o relógio; reiniciar Sim Sim
Ativar / desativar um usuário no dispositivo Não ("não compatível aqui") Sim
Copiar rostos e digitais entre dois dispositivos Não Sim
Fotos de usuários, fotos tiradas nas marcações Não Sim
Eventos de marcação ao vivo Não (consulta periódica) Sim, testado apenas em software (melhor com o SDK de 64 bits)
Precisa de software no PC Não Sim: o SDK da ZKTeco, registrado
Verificado em um dispositivo real Sim (iFace702, recursos somente de leitura) Não (apenas simulado)

As alterações em dispositivos também precisam ser permitidas na página do conector (veja Instalar) e as avançadas exigem o proprietário.

O PC do conector precisa ter Windows (64 bits) e direitos de administrador.

  1. Baixe você mesmo o ZKTeco Standalone SDK, no site da ZKTeco. O SolaHR nunca o inclui nem o redistribui. Você aceita os termos de licença da ZKTeco ao baixá-lo. Use a versão 6.3.1.37 ou posterior: ela contém uma pasta chamada 64bit com um zkemkeeper.dll real de 64 bits, compatível com o conector de 64 bits. Veja a nota abaixo sobre onde obtê-lo.
  2. Descompacte o pacote em algum lugar do PC (por exemplo, na pasta Downloads).
  3. Abra a pasta 64bit, clique com o botão direito em Register_SDK_x64.bat e escolha Executar como administrador. Ele copia os arquivos do SDK para a pasta de sistema do Windows e registra o zkemkeeper.dll para você.
  4. No SolaHR (página do dispositivo, Configurar o software necessário) ou na página do conector, clique em Verificar instalação.
  5. Leia as verificações. Quando todas estiverem Prontas, o cartão do dispositivo deixa de mostrar Configuração necessária e Testar conexão funciona.

Onde obter o SDK. A ZKTeco publica material de SDK em sua Central de Downloads (categoria SDK) e mantém um repositório Standalone-SDK em sua conta do GitHub. No momento em que escrevemos, conseguimos verificar que o repositório contém um pacote mais antigo de 32 bits (Communication Protocol SDK 6.2.4.11) e que a lista SDK da Central de Downloads mostra outros SDKs (módulos de digital e de luz visível); não conseguimos confirmar um link público para a 6.3.1.37. Alguns downloads da ZKTeco exigem um login gratuito de membro. Se não o encontrar, peça à ZKTeco ou ao seu distribuidor ZKTeco o "Standalone SDK 6.3.1.37 ou posterior, 64 bits". O link exibido no SolaHR também não foi verificado de forma independente.

#O que significam as verificações de prontidão

Verificar Significado Se aparecer Ausente
Windows O PC executa Windows. Um tipo SDK não funciona em outro sistema ("Este tipo de conexão não pode ser executado nesse PC").
Componente COM do Python O conector consegue se comunicar com componentes do Windows (pywin32). Faz parte do conector. Reinstale ou atualize o conector.
SDK registrado O Windows conhece o SDK (zkemkeeper). Execute Register_SDK_x64.bat como administrador.
Arquivo DLL O zkemkeeper.dll registrado existe no disco. Registre novamente; depois, não mova nem apague os arquivos.
Arquitetura O SDK é de 32 ou 64 bits, e o conector é de 64 bits. Um SDK somente de 32 bits não se encaixa diretamente: use o SDK de 64 bits ou a alternativa abaixo.

A verificação de prontidão é executada antes de cada teste de conexão e de cada consulta. A falta do SDK é um estado, "Configuração necessária": o SolaHR não tenta de novo em loop e não declara o dispositivo inacessível.

#Alternativa: um SDK antigo, somente de 32 bits

Os pacotes mais antigos têm apenas um componente de 32 bits, que o conector de 64 bits não consegue carregar diretamente. A página do conector então oferece Escolher DLL / Registrar (direitos de administrador; o Windows pedirá sua confirmação). Ela faz exatamente isto e nada além:

  • verifica se o arquivo escolhido é um arquivo local com o nome exato zkemkeeper.dll e se é uma DLL real do Windows;
  • registra esse único arquivo no Windows (regsvr32);
  • se o arquivo for de 32 bits, faz o Windows hospedá-lo em um processo auxiliar separado de 32 bits.

Ela nunca baixa nada, nunca executa outros arquivos e nunca altera um dispositivo. Por segurança, quando o conector roda como serviço, ele só registra uma DLL dentro de Program Files ou Windows; para uma DLL em outro lugar, um administrador executa solahr-dc sdk-setup --dll <path> em um prompt de comando elevado. solahr-dc readiness imprime o relatório atual e solahr-dc sdk-setup --candidates lista as cópias da DLL que ele encontra. Os eventos ao vivo podem ser pouco confiáveis por esse caminho; use o SDK de 64 bits para eles. Para desfazer: regsvr32 /u <path to dll>. Desinstalar o Device Connect não mexe no seu registro do SDK.

#Se o SDK não funcionar: use a conexão integrada

No painel Configurar o software necessário, clique em Usar a conexão integrada. Depois que você confirmar, o SolaHR muda o tipo de conexão para o direto, mantém o endereço IP e a porta, descarta as configurações do SDK e testa o dispositivo novamente. As marcações e as associações de funcionários são mantidas. Nada é alterado sem a sua confirmação.

#Restrições de licença dos fabricantes e outros fabricantes

SDK do fabricante Situação no Device Connect Restrições a conhecer
ZKTeco Standalone SDK (zkemkeeper) Implementado, testado apenas em software Licenciado pela ZKTeco. Não incluído e não redistribuível por nós: você o baixa da ZKTeco e aceita os termos dela (o repositório do GitHub que verificamos não mostra texto de licença; leia os termos que acompanham o seu download). Somente Windows. O registro vale para toda a máquina e exige direitos de administrador.
Suprema G-SDK Planejado, não implementado O repositório do G-SDK da Suprema informa que os downloads passam para a Central de Downloads da Suprema (a partir de 2 de março de 2026) e que nenhuma licença é indicada ali; os downloads podem exigir login de parceiro. Hoje os dispositivos Suprema são lidos por meio de um servidor BioStar 2.
Hikvision Device Network SDK Não planejado Desnecessário: os terminais Hikvision são lidos por ISAPI (protocolo web). As páginas de SDK da Hikvision existem para os seus próprios projetos; os guias de desenvolvedor de ISAPI no portal TPP exigem um contrato assinado e dados do parceiro.
Anviz CrossChex SDK Não planejado Desnecessário: os dispositivos Anviz são lidos pelo protocolo de rede deles ou pelo CrossChex Cloud. A Anviz tem uma página de download de SDK para os seus próprios projetos.

Nada aqui é aconselhamento jurídico: leia sempre a licença que acompanha o download do fabricante.