Çoğu terminal ağ üzerinden doğrudan okunur ve başka bir şeye gerek duymaz. Bazı bağlantı türleri, bağlayıcı bilgisayarda üreticinin kendi Windows yazılımını ("SDK") kullanır. Bugün bu yalnızca ZKTeco SDK içindir. Bu sayfa, ne zaman gerektiğini, adım adım nasıl kurulacağını, kontrollerin ne anlama geldiğini ve lisans kurallarını açıklar.
Önizleme ve açıklık notu. SDK yolu yalnızca yazılım simülasyonlarıyla geliştirildi ve denetlendi. Bir Windows bilgisayarda gerçek bir SDK kurulumuna karşı ve her modelin gerçek terminallerinde çalıştırılmadı. Gerçek bir bilgisayarda farklı olabilecek ayrıntılar: kayıt defteri düzeni,
regsvr32davranışı, SDK'nın bazı çağrılara verdiği tam yanıtlar. Önce tek bir cihazda deneyin. Çalışmazsa yerleşik doğrudan bağlantı her zaman kullanılabilir.
#Buna ihtiyacınız var mı?
Büyük olasılıkla hayır. Çoğu ZKTeco terminali için ZKTeco (doğrudan) seçeneğini seçin: okutmaları ve kullanıcıları okur, saati ayarlar, cihazı yeniden başlatır ve kullanıcıları düzenler; gerçek bir iFace702 üzerinde doğrulanmıştır. SDK türünü yalnızca doğrudan bağlantının yapamadığı şeylere ihtiyacınız varsa kullanın:
| Özellik | ZKTeco doğrudan | ZKTeco SDK |
|---|---|---|
| Okutmaları, kullanıcıları ve cihaz saatini okuma | Evet | Evet |
| Kullanıcı düzenleme, ekleme, silme; saat ayarlama; yeniden başlatma | Evet | Evet |
| Cihazdaki bir kullanıcıyı etkinleştirme / devre dışı bırakma | Hayır ("burada desteklenmiyor") | Evet |
| İki cihaz arasında yüz ve parmak izi kopyalama | Hayır | Evet |
| Kullanıcı fotoğrafları, okutma anındaki anlık fotoğraflar | Hayır | Evet |
| Canlı okutma olayları | Hayır (yoklama) | Evet, yalnızca yazılımla test edildi (en iyisi 64 bit SDK ile) |
| Bilgisayarda yazılım gerekir | Hayır | Evet: kayıtlı ZKTeco SDK |
| Gerçek bir cihazda doğrulandı | Evet (iFace702, salt okunur özellikler) | Hayır (yalnızca simülasyon) |
Cihazlarda değişikliğe ayrıca bağlayıcı sayfasından izin verilmelidir (Kurulum bölümüne bakın) ve gelişmiş olanlar için Sahip gerekir.
#Adım adım: 64 bit SDK (önerilir)
Bağlayıcı bilgisayarın Windows (64 bit) olması ve yönetici haklarına sahip olmanız gerekir.
- ZKTeco Standalone SDK'yı ZKTeco'dan kendiniz indirin. SolaHR bunu asla pakete dahil etmez veya yeniden dağıtmaz. İndirirken ZKTeco'nun lisans koşullarını kabul edersiniz. 6.3.1.37 veya sonraki sürümü kullanın:
64bitadlı bir klasör içerir ve bu klasörde 64 bit bağlayıcıyla uyumlu, gerçek bir 64 bitzkemkeeper.dllbulunur. Nereden edineceğinize dair aşağıdaki nota bakın. - Paketi bilgisayarda bir yere açın (örneğin İndirilenler klasörünün altına).
64bitklasörünü açın, Register_SDK_x64.bat dosyasına sağ tıklayın ve Yönetici olarak çalıştır seçeneğini seçin. SDK dosyalarını Windows sistem klasörüne kopyalar vezkemkeeper.dlldosyasını sizin için kaydeder.- SolaHR'da (cihaz sayfası, Gerekli yazılımı kur) veya bağlayıcı sayfasında Kurulumu doğrula düğmesine basın.
- Kontrolleri okuyun. Hepsi Hazır olduğunda cihaz kartı Kurulum gerekli durumundan çıkar ve Bağlantıyı sına çalışır.
SDK'yı nereden edinirsiniz. ZKTeco, SDK materyallerini Download Center bölümünde (SDK kategorisi) yayımlar ve GitHub hesabında bir Standalone-SDK deposu tutar. Yazı sırasında deponun daha eski bir 32 bit paket (Communication Protocol SDK 6.2.4.11) içerdiğini ve Download Center'ın SDK listesinde başka SDK'ların (parmak izi ve görünür ışık modülleri) yer aldığını doğrulayabildik; 6.3.1.37 için herkese açık bir bağlantıyı doğrulayamadık. Bazı ZKTeco indirmeleri ücretsiz üye girişi gerektirir. Bulamazsanız ZKTeco'dan veya ZKTeco distribütörünüzden "Standalone SDK 6.3.1.37 veya üzeri, 64 bit" isteyin. SolaHR'da gösterilen bağlantı da bağımsız olarak doğrulanmış değildir.
#Hazırlık kontrollerinin anlamı
| Kontrol | Anlamı | Eksik yazıyorsa |
|---|---|---|
| Windows | Bilgisayar Windows çalıştırıyor. | Bir SDK türü başka bir sistemde çalışamaz ("Bu bağlantı türü o bilgisayarda çalışamaz"). |
| Python COM bileşeni | Bağlayıcı Windows bileşenleriyle konuşabilir (pywin32). | Bağlayıcının bir parçasıdır. Bağlayıcıyı yeniden kurun veya yükseltin. |
| SDK kayıtlı | Windows SDK'yı tanıyor (zkemkeeper). |
Register_SDK_x64.bat dosyasını yönetici olarak çalıştırın. |
| DLL dosyası | Kayıtlı zkemkeeper.dll diskte mevcut. |
Yeniden kaydedin; sonrasında dosyaları taşımayın veya silmeyin. |
| Bit sayısı | SDK 32 bit veya 64 bit, bağlayıcı ise 64 bit. | Yalnızca 32 bit SDK doğrudan uymaz: 64 bit SDK'yı veya aşağıdaki yedek yolu kullanın. |
Hazırlık kontrolü, her bağlantı testinden ve yoklamadan önce çalışır. Eksik SDK bir durumdur, "Kurulum gerekli": SolaHR bir döngü içinde yeniden denemez ve cihaza ulaşılamıyor demez.
#Yedek yol: eski, yalnızca 32 bit SDK
Eski paketlerde yalnızca 32 bit bileşen bulunur ve 64 bit bağlayıcı bunu doğrudan yükleyemez. Bu durumda bağlayıcı sayfası DLL seç / Kaydet seçeneğini sunar (yönetici hakları; Windows onay isteyecektir). Tam olarak şunu yapar, başka bir şey yapmaz:
- seçilen dosyanın tam olarak
zkemkeeper.dlladlı yerel bir dosya ve gerçek bir Windows DLL'i olduğunu denetler; - bu tek dosyayı Windows'a kaydeder (
regsvr32); - dosya 32 bit ise Windows'un onu ayrı bir 32 bit yardımcı işlemde barındırmasını sağlar.
Hiçbir şey indirmez, başka dosyaları çalıştırmaz ve cihazı asla değiştirmez. Güvenlik için bağlayıcı hizmet olarak çalışırken yalnızca Program Files veya Windows altındaki bir DLL'i kaydeder; başka yerdeki bir DLL için yönetici, yükseltilmiş bir komut isteminden solahr-dc sdk-setup --dll <path> komutunu çalıştırır. solahr-dc readiness güncel raporu yazdırır, solahr-dc sdk-setup --candidates ise bulabildiği DLL kopyalarını listeler. Canlı olaylar bu yolla güvenilir olmayabilir; bunlar için 64 bit SDK'yı kullanın. Geri almak için: regsvr32 /u <path to dll>. Device Connect'i kaldırmak SDK kaydınıza dokunmaz.
#SDK çalışmazsa: yerleşik bağlantıyı kullanın
Gerekli yazılımı kur panelinde Bunun yerine yerleşik bağlantıyı kullan düğmesine basın. Onayınızdan sonra SolaHR bağlantı türünü doğrudan türe çevirir, IP adresini ve bağlantı noktasını korur, SDK ayarlarını kaldırır ve cihazı yeniden sınar. Okutmalar ve çalışan eşleşmeleri korunur. Onayınız olmadan hiçbir şey değiştirilmez.
#Üretici lisans kısıtlamaları ve diğer üreticiler
| Üretici SDK'sı | Device Connect'teki durumu | Bilinmesi gereken kısıtlamalar |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
Uygulandı, yalnızca yazılımla test edildi | ZKTeco tarafından lisanslanır. Pakete dahil değildir, tarafımızca yeniden dağıtılamaz: ZKTeco'dan indirir ve koşullarını kabul edersiniz (incelediğimiz GitHub deposunda lisans metni yoktur, bu yüzden indirmenizle gelen koşulları okuyun). Yalnızca Windows. Kayıt makine genelindedir ve yönetici hakları gerektirir. |
| Suprema G-SDK | Planlandı, uygulanmadı | Suprema'nın G-SDK deposu, indirmelerin Suprema Download Center'a taşındığını (2 Mart 2026'dan itibaren) belirtir ve orada lisans belirtilmemiştir; indirmeler iş ortağı girişi gerektirebilir. Bugün Suprema cihazları bunun yerine bir BioStar 2 sunucusu üzerinden okunur. |
| Hikvision Device Network SDK | Planlanmadı | Gerekmez: Hikvision terminalleri ISAPI (web protokolü) üzerinden okunur. Hikvision'ın SDK sayfaları kendi projeleriniz içindir; TPP portalındaki ISAPI geliştirici kılavuzları imzalı bir sözleşme ve iş ortağı bilgileri gerektirir. |
| Anviz CrossChex SDK | Planlanmadı | Gerekmez: Anviz, ağ protokolü veya CrossChex Cloud üzerinden okunur. Anviz'in kendi projeleriniz için bir SDK indirme sayfası vardır. |
Buradakilerin hiçbiri hukuki tavsiye değildir: üreticinin indirmesiyle gelen lisansı her zaman okuyun.