Solavel Documentos
Español

Configuración del SDK del fabricante (ZKTeco)

Última actualización

La mayoría de los terminales se leen directamente por la red y no necesitan nada más. Unos pocos tipos de conexión usan el software propio del fabricante para Windows (un “SDK”) en el PC del conector. Hoy eso es únicamente el SDK de ZKTeco. Esta página explica cuándo lo necesita, cómo instalarlo paso a paso, qué significan las comprobaciones y las reglas de licencia.

Nota de versión preliminar y transparencia. La vía del SDK se ha construido y comprobado únicamente con simulaciones de software. No se ha ejecutado con una instalación real del SDK en un PC con Windows ni con terminales reales de todos los modelos. Detalles que pueden diferir en un PC real: la estructura del registro, el comportamiento de regsvr32, las respuestas exactas del SDK a algunas llamadas. Pruébelo primero con un solo dispositivo. Si no funciona, la conexión directa integrada siempre está disponible.

#¿Lo necesita?

Probablemente no. Para la mayoría de los terminales ZKTeco elija ZKTeco (directo): lee fichajes y usuarios, ajusta el reloj, reinicia el dispositivo y edita usuarios, y se ha verificado en un iFace702 real. Use el tipo SDK solo si necesita lo que la conexión directa no puede hacer:

Funcionalidad ZKTeco directo SDK de ZKTeco
Leer fichajes, usuarios y reloj del dispositivo si si
Editar, añadir y eliminar usuarios; ajustar el reloj; reiniciar si si
Activar / desactivar un usuario en el dispositivo No (“no compatible aquí”) si
Copiar rostros y huellas entre dos dispositivos No si
Fotos de usuario, fotos instantáneas en los fichajes No si
Eventos de fichaje en directo No (sondeo) Sí, solo probado con software (mejor con el SDK de 64 bits)
Requiere software en el PC No Sí: el SDK de ZKTeco, registrado
Verificado en un dispositivo real Sí (iFace702, funciones de solo lectura) No (solo simulado)

Los cambios en los dispositivos también deben permitirse en la página del conector (consulte Instalar) y las funciones avanzadas requieren al propietario.

El PC del conector debe ser Windows (64 bits) y necesita derechos de administrador.

  1. Descargue usted mismo el ZKTeco Standalone SDK, desde ZKTeco. SolaHR nunca lo incluye ni lo redistribuye. Al descargarlo acepta los términos de licencia de ZKTeco. Use la versión 6.3.1.37 o posterior: contiene una carpeta llamada 64bit con un zkemkeeper.dll real de 64 bits que coincide con el conector de 64 bits. Consulte la nota siguiente sobre dónde obtenerlo.
  2. Descomprima el paquete en algún lugar del PC (por ejemplo, en la carpeta Descargas).
  3. Abra la carpeta 64bit, haga clic con el botón derecho en Register_SDK_x64.bat y elija Ejecutar como administrador. Copia los archivos del SDK a la carpeta del sistema de Windows y registra zkemkeeper.dll por usted.
  4. En SolaHR (página del dispositivo, Configurar el software necesario) o en la página del conector, pulse Verificar instalación.
  5. Lea las comprobaciones. Cuando todas estén en Listo, la tarjeta del dispositivo deja de mostrar Configuración necesaria y Probar conexión funciona.

Dónde obtener el SDK. ZKTeco publica material del SDK en su Centro de descargas (categoría SDK) y mantiene un repositorio Standalone-SDK en su cuenta de GitHub. En el momento de redactar esto pudimos comprobar que el repositorio contiene un paquete más antiguo de 32 bits (Communication Protocol SDK 6.2.4.11) y que la lista SDK del Centro de descargas muestra otros SDK (módulos de huella y de luz visible); no pudimos confirmar un enlace público a la versión 6.3.1.37. Algunas descargas de ZKTeco requieren un inicio de sesión de miembro gratuito. Si no lo encuentra, pida a ZKTeco o a su distribuidor de ZKTeco el “Standalone SDK 6.3.1.37 o posterior, de 64 bits”. Tampoco se ha verificado de forma independiente el enlace que muestra SolaHR.

#Qué significan las comprobaciones de preparación

Comprobar Significado Si dice Falta
Windows El PC ejecuta Windows. Un tipo de SDK no puede ejecutarse en otro sistema (“Este tipo de conexión no puede ejecutarse en ese PC”).
Componente COM de Python El conector puede comunicarse con componentes de Windows (pywin32). Forma parte del conector. Reinstale o actualice el conector.
SDK registrado Windows conoce el SDK (zkemkeeper). Ejecute Register_SDK_x64.bat como administrador.
Archivo DLL El zkemkeeper.dll registrado existe en el disco. Regístrelo de nuevo; después no mueva ni elimine los archivos.
Arquitectura (bits) El SDK es de 32 o de 64 bits, y el conector es de 64 bits. Un SDK solo de 32 bits no encaja directamente: use el SDK de 64 bits o la alternativa que se describe a continuación.

La comprobación de preparación se ejecuta antes de cada prueba de conexión y de cada sondeo. La falta del SDK es un estado, “Configuración necesaria”: SolaHR no reintenta en bucle ni declara el dispositivo inaccesible.

#Alternativa: un SDK antiguo solo de 32 bits

Los paquetes antiguos solo incluyen un componente de 32 bits, que el conector de 64 bits no puede cargar directamente. La página del conector ofrece entonces Elegir DLL / Registrar (derechos de administrador; Windows le pedirá confirmación). Hace exactamente esto y nada más:

  • comprueba que el archivo elegido sea un archivo local llamado exactamente zkemkeeper.dll y una DLL de Windows real;
  • registra ese único archivo en Windows (regsvr32);
  • si el archivo es de 32 bits, hace que Windows lo ejecute en un proceso auxiliar de 32 bits independiente.

Nunca descarga nada, nunca ejecuta otros archivos y nunca modifica un dispositivo. Por seguridad, cuando el conector se ejecuta como servicio solo registra una DLL ubicada en Program Files o en Windows; para una DLL en otro lugar, un administrador ejecuta solahr-dc sdk-setup --dll <path> desde un símbolo del sistema con privilegios elevados. solahr-dc readiness muestra el informe actual y solahr-dc sdk-setup --candidates enumera las copias de la DLL que puede encontrar. Con esta vía, los eventos en directo pueden ser poco fiables; use el SDK de 64 bits para ellos. Para deshacerlo: regsvr32 /u <path to dll>. Desinstalar Device Connect no afecta al registro de su SDK.

#Si el SDK no funciona: use la conexión integrada

En el panel Configurar el software necesario pulse Usar en su lugar la conexión integrada. Tras su confirmación, SolaHR cambia el tipo de conexión a la directa, conserva la dirección IP y el puerto, elimina los ajustes del SDK y vuelve a probar el dispositivo. Los fichajes y las asignaciones de empleados se conservan. No se cambia nada sin su confirmación.

#Restricciones de licencia del fabricante y otros fabricantes

SDK del fabricante Estado en Device Connect Restricciones que debe conocer
ZKTeco Standalone SDK (zkemkeeper) Implementado, solo probado con software Con licencia de ZKTeco. No se incluye ni podemos redistribuirlo: usted lo descarga de ZKTeco y acepta sus términos (el repositorio de GitHub que revisamos no muestra ningún texto de licencia, así que lea los términos que acompañan a su descarga). Solo para Windows. El registro afecta a todo el equipo y requiere derechos de administrador.
Suprema G-SDK Planificado, no implementado El repositorio G-SDK de Suprema indica que las descargas pasan al Centro de descargas de Suprema (desde el 2 de marzo de 2026) y no declara ninguna licencia; las descargas pueden requerir un inicio de sesión de socio. Hoy los dispositivos Suprema se leen mediante un servidor BioStar 2.
SDK de red de dispositivos de Hikvision No planificado No es necesario: los terminales Hikvision se leen mediante ISAPI (protocolo web). Las páginas del SDK de Hikvision existen para sus propios proyectos; sus guías de desarrollo de ISAPI en el portal TPP requieren un acuerdo firmado y datos de socio.
Anviz CrossChex SDK No planificado No es necesario: Anviz se lee mediante su protocolo de red o CrossChex Cloud. Anviz tiene una página de descarga del SDK para sus propios proyectos.

Nada de lo anterior es asesoramiento jurídico: lea siempre la licencia que acompaña a la descarga de un fabricante.