زیادہ تر ٹرمینلز نیٹ ورک پر براہ راست پڑھے جاتے ہیں اور انہیں کسی اور چیز کی ضرورت نہیں ہوتی۔ چند کنکشن اقسام کنیکٹر پی سی پر مینوفیکچرر کا اپنا ونڈوز سافٹ ویئر (ایک "SDK") استعمال کرتی ہیں۔ آج یہ صرف ZKTeco SDK ہے۔ یہ صفحہ بتاتا ہے کہ اس کی ضرورت کب پڑتی ہے، اسے مرحلہ وار کیسے انسٹال کریں، جانچ کا کیا مطلب ہے، اور لائسنس کے اصول۔
پیش نظارہ اور دیانت داری کا نوٹ۔ SDK کا راستہ صرف سافٹ ویئر سمولیشنز کے ساتھ بنایا اور جانچا گیا ہے۔ اسے ونڈوز پی سی پر حقیقی SDK انسٹالیشن کے خلاف، اور ہر ماڈل کے حقیقی ٹرمینلز پر نہیں چلایا گیا۔ حقیقی پی سی پر جن تفصیلات میں فرق ہو سکتا ہے: رجسٹری کی ترتیب،
regsvr32کا رویہ، اور بعض کالز پر SDK کے عین جوابات۔ پہلے ایک ڈیوائس پر آزمائیں۔ اگر یہ کام نہ کرے تو بلٹ اِن براہ راست کنکشن ہمیشہ دستیاب ہے۔
#کیا آپ کو اس کی ضرورت ہے؟
غالباً نہیں۔ زیادہ تر ZKTeco ٹرمینلز کے لیے ZKTeco (براہ راست) چنیں: یہ اندراجات اور صارفین پڑھتا ہے، گھڑی سیٹ کرتا ہے، ڈیوائس ری اسٹارٹ کرتا ہے اور صارفین میں ترمیم کرتا ہے، اور حقیقی iFace702 پر تصدیق شدہ ہے۔ SDK کی قسم صرف تب استعمال کریں جب آپ کو وہ چاہیے جو براہ راست نہیں کر سکتا:
| خصوصیت | ZKTeco براہ راست | ZKTeco SDK |
|---|---|---|
| اندراجات، صارفین اور ڈیوائس کی گھڑی پڑھنا | جی ہاں | جی ہاں |
| صارفین میں ترمیم، اضافہ، حذف؛ گھڑی سیٹ کرنا؛ ری اسٹارٹ | جی ہاں | جی ہاں |
| ڈیوائس پر صارف کو فعال / غیر فعال کرنا | نہیں ("یہاں معاون نہیں") | جی ہاں |
| دو ڈیوائسز کے درمیان چہرے اور فنگر پرنٹ کاپی کرنا | نہیں | جی ہاں |
| صارفین کی تصاویر، اندراج کے وقت کی تصاویر | نہیں | جی ہاں |
| براہ راست اندراج کے واقعات | نہیں (پولنگ) | جی ہاں، صرف سافٹ ویئر میں ٹیسٹ شدہ (64-بٹ SDK کے ساتھ بہترین) |
| پی سی پر سافٹ ویئر درکار ہے | نہیں | جی ہاں: ZKTeco SDK، رجسٹر شدہ |
| حقیقی ڈیوائس پر تصدیق شدہ | جی ہاں (iFace702، صرف پڑھنے والی خصوصیات) | نہیں (صرف سمولیشن) |
ڈیوائسز میں تبدیلیوں کی اجازت کنیکٹر کے صفحے پر بھی دی جانی چاہیے (انسٹال دیکھیں) اور جدید تبدیلیوں کے لیے مالک درکار ہے۔
#مرحلہ وار: 64-بٹ SDK (تجویز کردہ)
کنیکٹر پی سی Windows (64-بٹ) ہونا چاہیے اور آپ کے پاس ایڈمنسٹریٹر حقوق ہوں۔
- ZKTeco Standalone SDK خود ZKTeco سے ڈاؤن لوڈ کریں۔ SolaHR اسے کبھی ساتھ نہیں دیتا اور نہ دوبارہ تقسیم کرتا ہے۔ ڈاؤن لوڈ کرتے وقت آپ ZKTeco کی لائسنس شرائط قبول کرتے ہیں۔ ورژن 6.3.1.37 یا بعد کا استعمال کریں: اس میں
64bitنام کا فولڈر ہے جس میں 64-بٹ کنیکٹر سے ملتی جلتی اصلی 64-بٹzkemkeeper.dllہے۔ اسے کہاں سے لیں، اس کے بارے میں نیچے نوٹ دیکھیں۔ - پیکیج کو پی سی پر کہیں ان پیک کریں (مثلاً اپنے Downloads فولڈر میں)۔
64bitفولڈر کھولیں، Register_SDK_x64.bat پر رائٹ کلک کریں اور بطور ایڈمنسٹریٹر چلائیں چنیں۔ یہ SDK فائلیں ونڈوز سسٹم فولڈر میں کاپی کرتا ہے اور آپ کے لیےzkemkeeper.dllرجسٹر کر دیتا ہے۔- SolaHR میں (ڈیوائس کا صفحہ، مطلوبہ سافٹ ویئر سیٹ اپ کریں) یا کنیکٹر کے صفحے پر انسٹالیشن کی تصدیق کریں دبائیں۔
- جانچ کے نتائج پڑھیں۔ جب سب تیار ہوں تو ڈیوائس کارڈ سیٹ اپ درکار ہے سے نکل جاتا ہے اور کنکشن ٹیسٹ کریں کام کرتا ہے۔
SDK کہاں سے لیں۔ ZKTeco اپنے Download Center (زمرہ SDK) میں SDK مواد شائع کرتا ہے اور اپنے GitHub اکاؤنٹ پر Standalone-SDK ریپوزٹری رکھتا ہے۔ لکھتے وقت ہم یہ چیک کر سکے کہ ریپوزٹری میں پرانا 32-بٹ پیک (Communication Protocol SDK 6.2.4.11) ہے اور Download Center کی SDK فہرست میں دیگر SDKs (فنگر پرنٹ اور مرئی روشنی کے ماڈیولز) نظر آتے ہیں؛ ہم 6.3.1.37 کے عوامی لنک کی تصدیق نہیں کر سکے۔ ZKTeco کے کچھ ڈاؤن لوڈز کے لیے مفت ممبر لاگ اِن چاہیے۔ اگر آپ کو یہ نہ ملے تو ZKTeco یا اپنے ZKTeco ڈسٹری بیوٹر سے "Standalone SDK 6.3.1.37 یا بعد کا، 64-بٹ" مانگیں۔ SolaHR میں دکھایا گیا لنک بھی آزادانہ طور پر تصدیق شدہ نہیں ہے۔
#تیاری کی جانچ کا مطلب
| چیک کریں | معنی | اگر Missing لکھا ہو |
|---|---|---|
| Windows | پی سی Windows چلاتا ہے۔ | SDK کی قسم کسی اور سسٹم پر نہیں چل سکتی ("یہ کنکشن کی قسم اس پی سی پر نہیں چل سکتی")۔ |
| Python COM جزو | کنیکٹر ونڈوز کے اجزا سے بات کر سکتا ہے (pywin32)۔ | کنیکٹر کا حصہ۔ کنیکٹر دوبارہ انسٹال یا اپ گریڈ کریں۔ |
| SDK رجسٹر شدہ | ونڈوز SDK کو جانتا ہے (zkemkeeper)۔ |
Register_SDK_x64.bat بطور ایڈمنسٹریٹر چلائیں۔ |
| DLL فائل | رجسٹر شدہ zkemkeeper.dll ڈسک پر موجود ہے۔ |
دوبارہ رجسٹر کریں؛ بعد میں فائلوں کو نہ ہٹائیں اور نہ حذف کریں۔ |
| بٹ نیس | SDK 32-بٹ یا 64-بٹ ہے، اور کنیکٹر 64-بٹ ہے۔ | صرف 32-بٹ SDK براہ راست موزوں نہیں: 64-بٹ SDK استعمال کریں، یا نیچے دیا گیا متبادل۔ |
تیاری کی جانچ ہر کنکشن ٹیسٹ اور پول سے پہلے ہوتی ہے۔ SDK کا نہ ہونا ایک حالت ہے، "سیٹ اپ درکار ہے": SolaHR لوپ میں دوبارہ کوشش نہیں کرتا اور ڈیوائس کو ناقابل رسائی نہیں کہتا۔
#متبادل: پرانا، صرف 32-بٹ SDK
پرانے پیکس میں صرف 32-بٹ جزو ہوتا ہے، جسے 64-بٹ کنیکٹر براہ راست لوڈ نہیں کر سکتا۔ تب کنیکٹر کا صفحہ DLL چنیں / رجسٹر کریں پیش کرتا ہے (ایڈمنسٹریٹر حقوق؛ ونڈوز آپ سے تصدیق مانگے گا)۔ یہ بالکل یہی کرتا ہے اور اس سے زیادہ کچھ نہیں:
- جانچتا ہے کہ چنی گئی فائل مقامی فائل ہے جس کا نام بالکل
zkemkeeper.dllہے اور وہ اصلی Windows DLL ہے؛ - اسی ایک فائل کو ونڈوز کے ساتھ رجسٹر کرتا ہے (
regsvr32)؛ - اگر فائل 32-بٹ ہو تو ونڈوز کو اسے الگ 32-بٹ مددگار پروسیس میں چلانے پر لگاتا ہے۔
یہ کبھی کچھ ڈاؤن لوڈ نہیں کرتا، دیگر فائلیں نہیں چلاتا اور ڈیوائس میں کوئی تبدیلی نہیں کرتا۔ حفاظت کے لیے، جب کنیکٹر سروس کے طور پر چلتا ہے تو یہ صرف Program Files یا Windows کے تحت DLL رجسٹر کرتا ہے؛ کسی اور جگہ کی DLL کے لیے ایڈمنسٹریٹر بلند کمانڈ پرامپٹ سے solahr-dc sdk-setup --dll <path> چلاتا ہے۔ solahr-dc readiness موجودہ رپورٹ پرنٹ کرتا ہے اور solahr-dc sdk-setup --candidates DLL کی وہ کاپیاں فہرست کرتا ہے جو اسے مل سکیں۔ اس راستے سے براہ راست واقعات ناقابل اعتماد ہو سکتے ہیں؛ ان کے لیے 64-بٹ SDK استعمال کریں۔ واپس کرنے کے لیے: 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 | منصوبے میں، نافذ نہیں | Suprema کی G-SDK ریپوزٹری کہتی ہے کہ ڈاؤن لوڈز Suprema Download Center پر منتقل ہو رہے ہیں (2 مارچ 2026 سے) اور وہاں کوئی لائسنس درج نہیں؛ ڈاؤن لوڈز کے لیے پارٹنر لاگ اِن درکار ہو سکتا ہے۔ آج Suprema ڈیوائسز کو اس کی بجائے BioStar 2 سرور کے ذریعے پڑھا جاتا ہے۔ |
| Hikvision Device Network SDK | منصوبے میں نہیں | ضرورت نہیں: Hikvision ٹرمینلز ISAPI (ویب پروٹوکول) کے ذریعے پڑھے جاتے ہیں۔ Hikvision کے SDK صفحات آپ کے اپنے منصوبوں کے لیے ہیں؛ TPP پورٹل پر اس کی ISAPI ڈویلپر گائیڈز کے لیے دستخط شدہ معاہدہ اور پارٹنر تفصیلات چاہییں۔ |
| Anviz CrossChex SDK | منصوبے میں نہیں | ضرورت نہیں: Anviz کو اس کے نیٹ ورک پروٹوکول یا CrossChex Cloud کے ذریعے پڑھا جاتا ہے۔ Anviz کے پاس آپ کے اپنے منصوبوں کے لیے SDK ڈاؤن لوڈ صفحہ ہے۔ |
یہاں کچھ بھی قانونی مشورہ نہیں ہے: وینڈر کے ڈاؤن لوڈ کے ساتھ آنے والا لائسنس ہمیشہ پڑھیں۔