Support Hub/API & Integrations/أوضاع Native Push مقابل Hybrid: شجرة القرار الفنية
Translated from the English article and reviewed by a person. Read the English original
Developer

أوضاع Native Push مقابل Hybrid: شجرة القرار الفنية

أوضاع Native Push مقابل Hybrid: شجرة القرار الفنية

يتصل كل جهاز قياس حيوي بـ Cams Biometric Gateway من خلال أحد وضعي الدفع. يحدد الوضع الذي يستخدمه جهازك الواجهات البرمجية (APIs) المتاحة، وكيفية تسليم الأحداث، وكيفية ضبط بنيتك التحتية. يستعرض هذا الدليل كل متغير في القرار، من نوع الجهاز إلى طريقة الاتصال وطوبولوجيا النشر، حتى تتمكن من اختيار المسار الصحيح قبل بدء التطوير.

السؤال الأول: ما نوع الجهاز الذي تقوم بتوصيله؟

قبل اختيار طريقة الاتصال أو طوبولوجيا النشر، هناك سؤال أساسي يجب الإجابة عنه: هل جهازك من أجهزة Cams Biometrics، أم جهاز تم التحقق منه في بوابة مطوري Cams؟

تحدد الإجابة على هذا السؤال وضع الدفع الخاص بك بالكامل. إذا كانت الإجابة نعم، فاستخدم Native Push ولا حاجة لأي قرار إضافي. إذا كانت الإجابة لا، فأنت ضمن نطاق Hybrid Push، وتتبعه سلسلة من القرارات الإضافية.

الوضع 1
Native Push
لجميع أجهزة Cams Biometrics وأي جهاز مدرج كجهاز تم التحقق منه في developer.camsbiometrics.com. يتصل الجهاز مباشرة بـ Biometric Gateway عبر الإنترنت دون الحاجة إلى أي إعداد إضافي.

جميع العمليات الـ 38
Callback API كامل
RESTful API كامل

الوضع 2
Hybrid Push
لجميع الأجهزة الأخرى غير الموثقة. تختار طريقة اتصال وطوبولوجيا نشر تناسب بيئتك. تعتمد توفر الواجهات البرمجية (APIs) على التركيبة التي تختارها.

3 طرق اتصال
خياران للطوبولوجيا
وصول متغير إلى الواجهات البرمجية

Native Push: الصورة الكاملة

تحصل أجهزة Native Push على وصول كامل إلى جميع عمليات البوابة الـ 38 دون أي إعداد يتجاوز توصيل الجهاز بالإنترنت. يسلّم Callback API الأحداث دون أي زمن استجابة. تُنفَّذ أوامر RESTful API خلال نحو 15 ثانية. لا حاجة إلى SDK ولا إلى برامج محلية ولا إلى أي قرار بشأن الطوبولوجيا.

فهم Hybrid Push: ثلاث طرق اتصال

إذا لم يكن جهازك من أجهزة Cams أو من الأجهزة الموثقة، فإن القرار التالي هو كيفية تواصل البوابة فعلياً مع جهازك. توجد ثلاث طرق اتصال متاحة، ولكل منها متطلبات مختلفة وتداعيات مختلفة على ميزات الواجهات البرمجية التي يمكنك استخدامها.

لا تتعلق طريقة الاتصال بإعدادات الشبكة الخاصة بك. بل تتعلق بالآلية التقنية التي تستخدمها البوابة لقراءة البيانات من جهازك المحدد وإرسال الأوامر إليه. يتقيد هذا الاختيار بما يدعمه جهازك من إمكانات.

a
Device SDK
الخيار الأفضل للوصول الكامل إلى الواجهات البرمجية
تتواصل البوابة مع الجهاز باستخدام SDK الخاص بالشركة المصنعة للجهاز. يتولى SDK التعامل مع بروتوكول الجهاز على المستوى المنخفض، وتعرض البوابة جميع الميزات التي يدعمها SDK من خلال واجهتها البرمجية. هذه هي طريقة الاتصال الوحيدة في Hybrid Push التي تتيح عمليات RESTful API.
Callback API كامل + RESTful API كامل (ضمن إمكانات SDK)
b
DB Pull
بيانات الحضور فقط
تقرأ البوابة من قاعدة بيانات محلية تكتب فيها برامج إدارة الجهاز الخاصة به سجلات الحضور. تراقب البوابة قاعدة البيانات هذه وتدفع السجلات الجديدة إلى عنوان URL الخاص بالاستدعاء في الوقت الفعلي. لا يحدث أي اتصال مباشر بالجهاز، ولذلك لا يمكن إرسال أي أوامر إليه. العمليات مثل إضافة المستخدمين أو حذف السجلات أو تحميل السجلات غير متاحة.
Callback API: بيانات الحضور وسجلات البصمات فقط. RESTful API: غير مدعوم.
c
File Processing
بيانات الحضور فقط
يُراقَب باستمرار ملف حضور محدد على الكمبيوتر المحلي. في كل مرة تحدّث فيها برامج الجهاز هذا الملف بسجلات حضور جديدة، تكتشف البوابة التغيير، وتستخرج السجلات الجديدة، وتدفعها إلى عنوان URL الخاص بالاستدعاء في الوقت الفعلي. كما هو الحال مع DB Pull، تكون هذه الطريقة للقراءة فقط من منظور الجهاز، ولها نفس قيود الواجهات البرمجية.
Callback API: بيانات الحضور وسجلات البصمات فقط. RESTful API: غير مدعوم.
كيفية اختيار طريقة الاتصال

إذا كان جهازك يملك SDK من الشركة المصنعة تدعمه بوابة Cams، فاختر Device SDK (a). وهي الطريقة الوحيدة التي تفتح عمليات RESTful API لأجهزة Hybrid Push. إذا كان SDK غير مدعوم أو غير متاح، فإن DB Pull (b) أو File Processing (c) ستظل تسلّم بيانات الحضور إلى نقطة الاستدعاء الخاصة بك في الوقت الفعلي، وهو ما يكفي لكثير من حالات الاستخدام.

فهم Hybrid Push: طوبولوجيتا نشر

بعد اختيار طريقة الاتصال، يتمثل القرار الثاني في تحديد المكان الذي تتصل فيه البوابة بجهازك أو قاعدة بياناتك أو ملفك. هذا هو قرار الطوبولوجيا، ويعتمد على بيئة شبكتك في الموقع الفعلي للجهاز.

الطوبولوجيا X

مباشرة
يملك الكمبيوتر الموجود في الموقع الذي يتصل به الجهاز، أو الذي تعمل فيه برامج إدارة الجهاز، عنوان IP عام مع إعداد إعادة توجيه المنافذ (Port Forwarding) إلى الشبكة المحلية. تتصل Biometric Gateway مباشرة بالجهاز أو قاعدة البيانات أو الملفات عبر الإنترنت.
مطلوب: IP عام + إعادة توجيه المنافذ في الموقع
الطوبولوجيا Y

غير مباشرة
يتم تثبيت تطبيق Hybrid Connector على كمبيوتر الموقع المحلي. يعمل كجسر صادر بين الجهاز المحلي و Biometric Gateway، إذ يقيم الاتصال من الداخل بدلاً من الحاجة إلى اتصال وارد. لا يلزم وجود IP عام على جانب العميل.
مطلوب: تثبيت Hybrid Connector على الكمبيوتر المحلي. لا حاجة إلى IP عام.
توصية الطوبولوجيا

إذا لم تتمكن من إعداد IP عام أو إعادة توجيه المنافذ في الموقع، فاختر طوبولوجيا Indirect (Y) مع Hybrid Connector. وهي أبسط مسار للنشر، وتتجنب إعداد الشبكة على جانب العميل تماماً. إذا كان IP عام متاحاً ومُعدّاً، فإن طوبولوجيا Direct (X) تعمل أيضاً، ولا تتطلب تثبيت أي برامج إضافية في الموقع.

شجرة القرار: أي وضع يجب أن تختار؟

اتبع شجرة القرار هذه من الأعلى إلى الأسفل. توقف عند أول إجابة تنطبق على وضعك.

شجرة القرار، ابدأ من الأعلى
1. هل جهازك من أجهزة Cams Biometrics، أو مدرج كجهاز تم التحقق منه في developer.camsbiometrics.com؟
نعم استخدم Native Push. وصول كامل إلى الواجهات البرمجية. لا حاجة لأي قرارات إضافية.
لا انتقل إلى السؤال 2.
2. هل تدعم بوابة Cams الـ SDK الخاص بالشركة المصنعة لجهازك؟
نعم استخدم Hybrid Push، Device SDK (a). وصول كامل إلى Callback API و RESTful API ضمن حدود SDK. انتقل إلى السؤال 3 لاختيار الطوبولوجيا.
لا انتقل إلى السؤال 2b.
2b. هل تكتب برامج إدارة الجهاز سجلات الحضور في قاعدة بيانات محلية؟
نعم استخدم Hybrid Push، DB Pull (b). Callback للحضور فقط. انتقل إلى السؤال 3 لاختيار الطوبولوجيا.
3. هل يملك كمبيوتر الموقع عنوان IP عام مع إعادة توجيه المنافذ متاحة؟
نعم استخدم الطوبولوجيا المباشرة (X). لا حاجة إلى برامج إضافية في الموقع.
لا استخدم الطوبولوجيا غير المباشرة (Y). ثبّت Hybrid Connector على كمبيوتر الموقع المحلي.

مصفوفة توفر ميزات Hybrid Push

يعرض الجدول أدناه كل تركيبة من طريقة الاتصال وطوبولوجيا النشر، وميزات الواجهات البرمجية المتاحة في كل حالة. استخدمه إلى جانب شجرة القرار للتأكد مما تدعمه التهيئة التي اخترتها.

الوضع الاتصال الطوبولوجيا Callback API RESTful API
جهاز مباشر (a) Device SDK (X) IP عام كامل كامل (تنطبق حدود SDK)
جهاز غير مباشر (a) Device SDK (Y) Hybrid Connector كامل كامل (تنطبق حدود SDK)
قاعدة بيانات مباشرة (b) DB Pull (X) IP عام الحضور فقط غير مدعوم
قاعدة بيانات غير مباشرة (b) DB Pull (Y) Hybrid Connector الحضور فقط غير مدعوم
ملف مباشر (c) File Processing (X) IP عام الحضور فقط غير مدعوم
ملف غير مباشر (c) File Processing (Y) Hybrid Connector الحضور فقط غير مدعوم
تنبيه هام بشأن الأجهزة

يمكن لقيود الأجهزة أن تحد من ميزات الواجهات البرمجية حتى ضمن وضع Device SDK. قد لا تعمل واجهات برمجية معينة حسب إصدار البرنامج الثابت (Firmware) لطراز الجهاز، أو حسب الإمكانات التي يعرضها SDK الخاص بالشركة المصنعة. تصف المصفوفة أعلاه ما تدعمه بنية البوابة، وليس ما يضمن كل طراز جهاز فردي دعمه. اختبر دائماً باستخدام جهازك المحدد، وتحقق من الحالات الحدية مع فريق دعم Cams قبل النشر في بيئة الإنتاج.

ما الذي تؤثر فيه قرارات الطوبولوجيا وما الذي لا تؤثر فيه

من نقاط الالتباس الشائعة العلاقة بين الطوبولوجيا وتوفر الواجهات البرمجية. لا يؤثر اختيار الطوبولوجيا، سواء كانت Direct أو Indirect، في الميزات المتاحة من الواجهات البرمجية. تُحدَّد مجموعة ميزات الواجهات البرمجية بالكامل بطريقة الاتصال.

ما تؤثر فيه الطوبولوجيا هو كيفية إقامة الاتصال الشبكي بين البوابة وبيئتك المحلية. تتطلب طوبولوجيا Direct عنوان IP عام وإعادة توجيه المنافذ في الموقع. تتطلب طوبولوجيا Indirect تثبيت Hybrid Connector على الجهاز المحلي. ميزات الواجهات البرمجية المتاحة لك متطابقة في Direct Device SDK و Indirect Device SDK، ومتطابقة في Direct DB Pull و Indirect DB Pull.

“اختر طريقة الاتصال بناءً على ميزات الواجهات البرمجية التي يحتاجها تكاملك. اختر الطوبولوجيا بناءً على ما تدعمه بيئة شبكتك. هذان قراران مستقلان.”

الأسئلة الشائعة

هل يمكنني استخدام DB Pull أو File Processing مع أوامر RESTful API؟
لا. إن DB Pull و File Processing طريقتا تكامل للقراءة فقط. تتيحان للبوابة مراقبة بيانات الحضور التي يولّدها برنامج الجهاز نفسه، لكنهما لا تنشئان قناة يمكن من خلالها إرسال الأوامر مرة أخرى إلى الجهاز. تتطلب عمليات RESTful API مثل إضافة المستخدمين أو حذف السجلات أو تحميل السجلات وضع Device SDK، الذي يُنشئ قناة اتصال ثنائية الاتجاه.
هل يجب تثبيت Hybrid Connector على الجهاز نفسه الذي يعمل عليه برنامج الجهاز؟
نعم. يجب تثبيت Hybrid Connector على الكمبيوتر المحلي نفسه الذي يتصل به الجهاز أو الذي تعمل عليه برامج إدارة الجهاز. ويرجع ذلك إلى أنه يحتاج إلى وصول محلي إلى الجهاز أو قاعدة البيانات المحلية أو ملف الحضور، حسب طريقة الاتصال التي تستخدمها. ثم ينشئ Connector نفقاً صادراً إلى البوابة، مما يلغي الحاجة إلى IP عام في ذلك الموقع.
ما الفرق في زمن الاستجابة بين Native Push و Hybrid Push؟
في Native Push، تُسلَّم أحداث Callback API دون أي زمن استجابة، وتُنفَّذ أوامر RESTful API خلال نحو 30 ثانية. أما في Hybrid Push باستخدام Device SDK، فيعتمد زمن الاستجابة على دورة الاتصال الخاصة بالـ SDK، ويختلف حسب الشركة المصنعة للجهاز. ويعتمد زمن استجابة DB Pull و File Processing على عدد مرات كتابة البرنامج المحلي للسجلات الجديدة، والسرعة التي تكتشف بها البوابة التغيير، وعادةً ما يكون ذلك خلال بضع ثوانٍ من تسجيل الجهاز للحدث.

الخلاصة: اختر وضعك بما يتوافق مع قيودك

إن قرار وضع الاتصال الخاص بـ Cams Biometric Gateway ليس مسألة تفضيل، بل مسألة قيود. يُعد Native Push الإجابة الصحيحة إذا كان جهازك مؤهلاً، لأنه يوفر أكبر قدر من الإمكانات بأقل قدر من الإعدادات. أما Hybrid Push فهو الحل لكل ما عداه، وضمنه يمنحك وضع Device SDK أقرب ما يكون إلى Native Push من حيث الوصول إلى الواجهات البرمجية.

عندما لا يكون الوصول الكامل إلى SDK متاحاً، تمثل DB Pull و File Processing مساراً عملياً يظل يوصل بيانات الحضور الفعلية إلى أنظمتك في الوقت الفعلي. أما قرار الطوبولوجيا فهو اختيار منفصل على مستوى البنية التحتية، ولا يغيّر ما تستطيع الواجهة البرمجية تنفيذه.

ابدأ بشجرة القرار، ثم تحقق من اختيارك مقابل مصفوفة الميزات، واختبر باستخدام جهازك، وتحقق من أي حالات حدية مع فريق دعم Cams قبل الانتقال إلى بيئة الإنتاج.

Was this article helpful?