Die meisten Terminals werden direkt über das Netzwerk gelesen und brauchen nichts weiter. Einige Verbindungstypen nutzen die eigene Windows-Software des Herstellers (ein „SDK“) auf dem Connector-PC. Derzeit ist das nur das ZKTeco SDK. Diese Seite erklärt, wann Sie es brauchen, wie Sie es Schritt für Schritt installieren, was die Prüfungen bedeuten und welche Lizenzregeln gelten.
Hinweis zu Vorschau und Ehrlichkeit. Der SDK-Weg wurde nur mit Softwaresimulationen gebaut und geprüft. Er wurde nicht mit einer echten SDK-Installation auf einem Windows-PC und nicht mit echten Terminals jedes Modells ausgeführt. Dinge, die auf einem echten PC abweichen können: der Aufbau der Registry, das Verhalten von
regsvr32, die genauen Antworten des SDK auf einige Aufrufe. Probieren Sie es zuerst an einem Gerät aus. Wenn es nicht funktioniert, steht die integrierte direkte Verbindung immer zur Verfügung.
#Brauchen Sie es?
Wahrscheinlich nicht. Wählen Sie für die meisten ZKTeco-Terminals ZKTeco (direkt): Es liest Stempelungen und Benutzer, stellt die Uhr, startet das Gerät neu und bearbeitet Benutzer und wurde an einem echten iFace702 verifiziert. Verwenden Sie den SDK-Typ nur, wenn Sie brauchen, was die direkte Verbindung nicht kann:
| Funktion | ZKTeco direkt | ZKTeco SDK |
|---|---|---|
| Stempelungen, Benutzer und Geräteuhr lesen | Ja | Ja |
| Benutzer bearbeiten, hinzufügen, löschen; Uhr stellen; neu starten | Ja | Ja |
| Einen Benutzer am Gerät aktivieren / deaktivieren | Nein („hier nicht unterstützt“) | Ja |
| Gesichter und Fingerabdrücke kopieren zwischen zwei Geräten | Nein | Ja |
| Benutzerfotos, Momentaufnahmen bei Stempelungen | Nein | Ja |
| Live-Stempelereignisse | Nein (Abfrage) | Ja, nur per Software getestet (am besten mit dem 64-Bit-SDK) |
| Benötigt Software auf dem PC | Nein | Ja: das ZKTeco SDK, registriert |
| An einem echten Gerät verifiziert | Ja (iFace702, nur lesende Funktionen) | Nein (nur simuliert) |
Änderungen an Geräten müssen außerdem auf der Connector-Seite zugelassen sein (siehe Installation); für die weitergehenden ist der Inhaber erforderlich.
#Schritt für Schritt: das 64-Bit-SDK (empfohlen)
Der Connector-PC muss Windows (64-Bit) verwenden, und Sie brauchen Administrator-Rechte.
- Laden Sie das ZKTeco Standalone SDK selbst von ZKTeco herunter. SolaHR bündelt oder verteilt es niemals. Beim Download akzeptieren Sie die Lizenzbedingungen von ZKTeco. Verwenden Sie Version 6.3.1.37 oder neuer: Sie enthält einen Ordner namens
64bitmit einer echten 64-Bit-zkemkeeper.dll, die zum 64-Bit-Connector passt. Hinweise, wo Sie es bekommen, finden Sie unten. - Entpacken Sie das Paket an einer beliebigen Stelle auf dem PC (zum Beispiel im Ordner Downloads).
- Öffnen Sie den Ordner
64bit, klicken Sie mit der rechten Maustaste auf Register_SDK_x64.bat und wählen Sie Als Administrator ausführen. Das kopiert die SDK-Dateien in den Windows-Systemordner und registriertzkemkeeper.dllfür Sie. - Klicken Sie in SolaHR (Geräteseite, Erforderliche Software einrichten) oder auf der Connector-Seite auf Installation prüfen.
- Lesen Sie die Prüfungen. Wenn alle Bereit zeigen, verlässt die Gerätekarte Einrichtung erforderlich und Verbindung testen funktioniert.
Wo Sie das SDK bekommen. ZKTeco veröffentlicht SDK-Material im Download Center (Kategorie SDK) und führt in seinem GitHub-Konto ein Standalone-SDK-Repository. Zum Zeitpunkt des Schreibens konnten wir feststellen, dass das Repository ein älteres 32-Bit-Paket enthält (Communication Protocol SDK 6.2.4.11) und dass die SDK-Liste des Download Centers andere SDKs zeigt (Fingerabdruck- und Sichtlichtmodule); einen öffentlichen Link zu 6.3.1.37 konnten wir nicht bestätigen. Einige ZKTeco-Downloads erfordern ein kostenloses Mitglieds-Login. Wenn Sie es nicht finden, fragen Sie ZKTeco oder Ihren ZKTeco-Händler nach dem „Standalone SDK 6.3.1.37 oder neuer, 64-Bit“. Auch der in SolaHR angezeigte Link ist nicht unabhängig verifiziert.
#Was die Bereitschaftsprüfungen bedeuten
| Prüfen | Bedeutung | Wenn „Fehlt“ steht |
|---|---|---|
| Windows | Der PC läuft unter Windows. | Ein SDK-Typ kann auf einem anderen System nicht laufen („Dieser Verbindungstyp kann auf diesem PC nicht laufen“). |
| Python-COM-Komponente | Der Connector kann mit Windows-Komponenten kommunizieren (pywin32). | Teil des Connectors. Installieren Sie den Connector erneut oder aktualisieren Sie ihn. |
| SDK registriert | Windows kennt das SDK (zkemkeeper). |
Führen Sie Register_SDK_x64.bat als Administrator aus. |
| DLL-Datei | Die registrierte zkemkeeper.dll existiert auf dem Datenträger. |
Registrieren Sie erneut; verschieben oder löschen Sie die Dateien danach nicht. |
| Bitbreite | Das SDK ist 32-Bit oder 64-Bit, und der Connector ist 64-Bit. | Ein reines 32-Bit-SDK passt nicht direkt: Verwenden Sie das 64-Bit-SDK oder die Ausweichlösung unten. |
Die Bereitschaftsprüfung läuft vor jedem Verbindungstest und jeder Abfrage. Ein fehlendes SDK ist ein Status, „Einrichtung erforderlich“: SolaHR versucht es nicht in einer Schleife erneut und meldet das Gerät nicht als nicht erreichbar.
#Ausweichlösung: ein älteres, reines 32-Bit-SDK
Ältere Pakete haben nur eine 32-Bit-Komponente, die der 64-Bit-Connector nicht direkt laden kann. Die Connector-Seite bietet dann DLL wählen / Registrieren an (Administratorrechte; Windows bittet um Bestätigung). Das tut genau Folgendes und nicht mehr:
- prüft, ob die gewählte Datei eine lokale Datei mit genau dem Namen
zkemkeeper.dllund eine echte Windows-DLL ist; - registriert genau diese eine Datei bei Windows (
regsvr32); - wenn die Datei 32-Bit ist, lässt Windows sie in einem separaten 32-Bit-Hilfsprozess laufen.
Es lädt nie etwas herunter, führt nie andere Dateien aus und ändert nie ein Gerät. Aus Sicherheitsgründen registriert der Connector, wenn er als Dienst läuft, nur eine DLL unter Program Files oder Windows; für eine DLL an anderer Stelle führt ein Administrator solahr-dc sdk-setup --dll <path> in einer Eingabeaufforderung mit erhöhten Rechten aus. solahr-dc readiness gibt den aktuellen Bericht aus und solahr-dc sdk-setup --candidates listet die Kopien der DLL auf, die gefunden werden. Live-Ereignisse sind auf diesem Weg möglicherweise unzuverlässig; verwenden Sie dafür das 64-Bit-SDK. Zum Rückgängigmachen: regsvr32 /u <path to dll>. Das Deinstallieren von Device Connect lässt Ihre SDK-Registrierung unangetastet.
#Wenn das SDK nicht funktioniert: die integrierte Verbindung verwenden
Klicken Sie im Feld Erforderliche Software einrichten auf Stattdessen die integrierte Verbindung verwenden. Nach Ihrer Bestätigung stellt SolaHR den Verbindungstyp auf die direkte Verbindung um, behält IP-Adresse und Port, verwirft die SDK-Einstellungen und testet das Gerät erneut. Stempelungen und Mitarbeiterzuordnungen bleiben erhalten. Ohne Ihre Bestätigung wird nichts umgestellt.
#Lizenzbeschränkungen der Hersteller und weitere Hersteller
| Hersteller-SDK | Status in Device Connect | Zu beachtende Einschränkungen |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
Umgesetzt, nur per Software getestet | Von ZKTeco lizenziert. Nicht gebündelt, von uns nicht weiterverteilbar: Sie laden es von ZKTeco herunter und akzeptieren dessen Bedingungen (das von uns geprüfte GitHub-Repository enthält keinen Lizenztext, lesen Sie also die Bedingungen, die Ihrem Download beiliegen). Nur Windows. Die Registrierung gilt für den ganzen Rechner und erfordert Administratorrechte. |
| Suprema G-SDK | Geplant, nicht umgesetzt | Das G-SDK-Repository von Suprema nennt als neuen Ort für Downloads das Suprema Download Center (ab dem 2. März 2026) und gibt dort keine Lizenz an; für Downloads kann ein Partner-Login nötig sein. Derzeit werden Suprema-Geräte stattdessen über einen BioStar 2-Server gelesen. |
| Hikvision Device Network SDK | Nicht geplant | Nicht nötig: Hikvision-Terminals werden über ISAPI (Webprotokoll) gelesen. Die SDK-Seiten von Hikvision gibt es für eigene Projekte; die ISAPI-Entwicklerhandbücher im TPP-Portal erfordern eine unterzeichnete Vereinbarung und Partnerangaben. |
| Anviz CrossChex SDK | Nicht geplant | Nicht nötig: Anviz wird über sein Netzwerkprotokoll oder CrossChex Cloud gelesen. Anviz hat eine SDK-Download-Seite für eigene Projekte. |
Nichts hiervon ist Rechtsberatung: Lesen Sie stets die Lizenz, die dem Download eines Herstellers beiliegt.