تُقرأ معظم الأجهزة مباشرة عبر الشبكة ولا تحتاج إلى شيء آخر. وتستخدم بعض أنواع الاتصال برنامج Windows الخاص بالمصنّع (المسمى "SDK") على حاسوب الموصّل. وهو حاليًا ZKTeco SDK فقط. تشرح هذه الصفحة متى تحتاج إليه، وكيف تثبّته خطوة بخطوة، ومعنى الفحوصات، وقواعد الترخيص.
ملاحظة عن الحالة التجريبية والصراحة. بُني مسار SDK وفُحص بمحاكاة برمجية فقط. ولم يُشغَّل مع تثبيت حقيقي لـ SDK على حاسوب Windows، ولا على أجهزة حقيقية من كل طراز. من التفاصيل التي قد تختلف على حاسوب حقيقي: بنية السجل (registry)، وسلوك
regsvr32، والإجابات الدقيقة التي يعطيها SDK لبعض الاستدعاءات. جرّبه على جهاز واحد أولًا. وإذا لم يعمل، فالاتصال المباشر المدمج متاح دائمًا.
#هل تحتاج إليه؟
على الأرجح لا. لمعظم أجهزة ZKTeco اختر ZKTeco (مباشر): فهو يقرأ البصمات والمستخدمين، ويضبط الساعة، ويعيد تشغيل الجهاز، ويعدّل المستخدمين، وقد جرى التحقق منه على جهاز iFace702 حقيقي. استخدم نوع SDK فقط إذا احتجت إلى ما لا يستطيعه الاتصال المباشر:
| ميزة | ZKTeco مباشر | ZKTeco SDK |
|---|---|---|
| قراءة البصمات والمستخدمين وساعة الجهاز | نعم | نعم |
| تعديل المستخدمين وإضافتهم وحذفهم؛ وضبط الساعة؛ وإعادة التشغيل | نعم | نعم |
| تفعيل / تعطيل مستخدم على الجهاز | لا ("غير مدعوم هنا") | نعم |
| نسخ الوجوه والبصمات بين جهازين | لا | نعم |
| صور المستخدمين، ولقطات الصور عند البصمات | لا | نعم |
| أحداث البصمة المباشرة | لا (استعلام دوري) | نعم، بالاختبار البرمجي فقط (الأفضل مع SDK بنسخة 64 بت) |
| يحتاج إلى برنامج على الحاسوب | لا | نعم: ZKTeco SDK، مسجَّلًا |
| جرى التحقق منه على جهاز حقيقي | نعم (iFace702، ميزات القراءة فقط) | لا (محاكاة فقط) |
يجب أيضًا السماح بالتغييرات على الأجهزة في صفحة الموصّل (راجع التثبيت)، وتحتاج المتقدمة منها إلى المالك.
#خطوة بخطوة: SDK بنسخة 64 بت (الموصى به)
يجب أن يعمل حاسوب الموصّل بنظام Windows (64 بت) وأن تملك صلاحيات المسؤول.
- نزّل ZKTeco Standalone SDK بنفسك من ZKTeco. فلا يضمّه SolaHR ولا يعيد توزيعه أبدًا. وتقبل شروط ترخيص ZKTeco عند التنزيل. استخدم الإصدار 6.3.1.37 أو أحدث: ففيه مجلد باسم
64bitيحوي ملفzkemkeeper.dllحقيقيًا بنسخة 64 بت يتوافق مع الموصّل بنسخة 64 بت. راجع الملاحظة أدناه عن مكان الحصول عليه. - فُكّ ضغط الحزمة في أي مكان على الحاسوب (مثل مجلد التنزيلات).
- افتح المجلد
64bit، وانقر بزر الفأرة الأيمن على Register_SDK_x64.bat واختر تشغيل كمسؤول. فهو ينسخ ملفات SDK إلى مجلد نظام Windows ويسجّلzkemkeeper.dllنيابةً عنك. - في SolaHR (صفحة الجهاز، إعداد البرنامج المطلوب) أو في صفحة الموصّل، اضغط التحقق من التثبيت.
- اقرأ الفحوصات. عندما تصبح جميعها جاهزة، تغادر بطاقة الجهاز حالة الإعداد مطلوب ويعمل اختبار الاتصال.
أين تجد SDK. تنشر ZKTeco مواد SDK في مركز التنزيلات (الفئة SDK) وتحتفظ بـمستودع Standalone-SDK على حسابها في GitHub. وقت كتابة هذا الدليل أمكننا التحقق من أن المستودع يضم حزمة أقدم بنسخة 32 بت (Communication Protocol SDK 6.2.4.11) وأن قائمة SDK في مركز التنزيلات تعرض حزم SDK أخرى (وحدات البصمة والضوء المرئي)؛ ولم نتمكن من تأكيد رابط عام للإصدار 6.3.1.37. وتحتاج بعض تنزيلات ZKTeco إلى تسجيل دخول مجاني كعضو. وإذا لم تجده، فاطلب من ZKTeco أو من موزّعها "Standalone SDK 6.3.1.37 أو أحدث، 64 بت". كما أن الرابط المعروض في SolaHR لم يُتحقق منه بشكل مستقل أيضًا.
#معنى فحوصات الجاهزية
| تحقق | معنى | إذا ظهرت "مفقود" |
|---|---|---|
| Windows | يعمل الحاسوب بنظام Windows. | لا يمكن لنوع SDK أن يعمل على نظام آخر ("لا يمكن لنوع الاتصال هذا أن يعمل على ذلك الحاسوب"). |
| مكوّن Python COM | يستطيع الموصّل التحدث إلى مكوّنات Windows (pywin32). | جزء من الموصّل. أعد تثبيت الموصّل أو رقِّه. |
| تسجيل SDK | يعرف Windows الـ SDK (zkemkeeper). |
شغّل Register_SDK_x64.bat كمسؤول. |
| ملف DLL | ملف zkemkeeper.dll المسجَّل موجود على القرص. |
سجّله من جديد؛ ولا تنقل الملفات أو تحذفها بعد ذلك. |
| عرض المعالج (Bitness) | الـ SDK بنسخة 32 بت أو 64 بت، والموصّل بنسخة 64 بت. | لا يناسب SDK بنسخة 32 بت فقط الاتصال المباشر: استخدم SDK بنسخة 64 بت، أو البديل أدناه. |
تعمل فحوصات الجاهزية قبل كل اختبار اتصال وكل استعلام دوري. غياب SDK حالة اسمها "الإعداد مطلوب": فلا يعيد SolaHR المحاولة في حلقة ولا يعدّ الجهاز غير قابل للوصول.
#البديل: SDK قديم بنسخة 32 بت فقط
تحتوي الحزم الأقدم على مكوّن بنسخة 32 بت فقط، لا يستطيع الموصّل بنسخة 64 بت تحميله مباشرة. وعندها تعرض صفحة الموصّل اختيار DLL / تسجيل (يحتاج إلى صلاحيات المسؤول؛ وسيطلب منك Windows التأكيد). وهو يفعل هذا بالضبط ولا شيء غيره:
- يتحقق من أن الملف المختار ملف محلي يحمل الاسم
zkemkeeper.dllتمامًا وأنه ملف DLL حقيقي لنظام Windows؛ - يسجّل ذلك الملف وحده في Windows (
regsvr32)؛ - وإذا كان الملف بنسخة 32 بت، يجعل Windows يستضيفه في عملية مساعدة منفصلة بنسخة 32 بت.
لا ينزّل شيئًا أبدًا، ولا يشغّل ملفات أخرى، ولا يغيّر أي جهاز. ولأجل الأمان، عندما يعمل الموصّل كخدمة فإنه يسجّل ملف DLL الموجود تحت Program Files أو Windows فقط؛ أما ملف DLL في مكان آخر فيشغّل المسؤول solahr-dc sdk-setup --dll <path> من موجّه أوامر مرفوع الصلاحيات. ويطبع solahr-dc readiness التقرير الحالي، ويعرض solahr-dc sdk-setup --candidates نسخ ملف DLL التي يجدها. وقد لا تكون الأحداث المباشرة موثوقة عبر هذا المسار؛ فاستخدم SDK بنسخة 64 بت لها. وللتراجع: regsvr32 /u <path to dll>. ولا تمسّ إزالة Device Connect تسجيل SDK لديك.
#إذا لم يعمل SDK: استخدم الاتصال المدمج
في لوحة إعداد البرنامج المطلوب اضغط استخدام الاتصال المدمج بدلًا من ذلك. بعد أن تؤكد، يغيّر SolaHR نوع الاتصال إلى المباشر، ويُبقي عنوان IP والمنفذ، ويُسقط إعدادات SDK، ويختبر الجهاز من جديد. وتُحفظ البصمات وروابط الموظفين. ولا يتغير شيء دون تأكيدك.
#قيود تراخيص الشركات المصنّعة والشركات الأخرى
| SDK الشركة المصنّعة | الحالة في Device Connect | قيود يجب معرفتها |
|---|---|---|
ZKTeco Standalone SDK (zkemkeeper) |
منفَّذ، اختُبر برمجيًا فقط | مرخَّص من ZKTeco. غير مضمَّن ولا يمكننا إعادة توزيعه: تنزّله من ZKTeco وتقبل شروطه (لا يعرض مستودع GitHub الذي فحصناه نص ترخيص، فاقرأ الشروط المرفقة بتنزيلك). يعمل على Windows فقط. التسجيل على مستوى الجهاز كله ويحتاج إلى صلاحيات المسؤول. |
| Suprema G-SDK | مخطط له، غير منفَّذ | يذكر مستودع G-SDK من Suprema أن التنزيلات انتقلت إلى مركز تنزيلات Suprema (اعتبارًا من 2 مارس 2026) ولا يُذكر فيه أي ترخيص؛ وقد تتطلب التنزيلات تسجيل دخول كشريك. وحاليًا تُقرأ أجهزة Suprema عبر خادم BioStar 2 بدلًا من ذلك. |
| Hikvision Device Network SDK | غير مخطط له | غير مطلوب: تُقرأ أجهزة Hikvision عبر ISAPI (بروتوكول الويب). تتوفر صفحات SDK من Hikvision لمشاريعك الخاصة؛ أما أدلة مطوّري ISAPI على بوابة TPP فتحتاج إلى اتفاقية موقّعة وبيانات الشريك. |
| Anviz CrossChex SDK | غير مخطط له | غير مطلوب: تُقرأ أجهزة Anviz عبر بروتوكول الشبكة الخاص بها أو CrossChex Cloud. لدى Anviz صفحة تنزيل SDK لمشاريعك الخاصة. |
لا شيء هنا يُعدّ استشارة قانونية: اقرأ دائمًا الترخيص المرفق بتنزيل الشركة المصنّعة.