ما هي وثائق SDK التي يمكنني الحصول عليها لدمج هذه الكاميرات في منصة الأمان الخاصة بي؟

لقد رأيت الكثير من المشاريع تفشل لأن بائع الكاميرا سلّم “SDK” الذي كان مجرد ملف DLL قديم بدون أي وثائق. إنه أمر محبط ومكلف.

لدمج كاميرات PTZ الاحترافية في منصة الأمان الخاصة بك، يمكنك عادةً الوصول إلى ثلاثة مستويات من الوثائق: حزم SDK الأصلية (C++C/C#/Java) للتطبيقات عالية الأداء, واجهات برمجة تطبيقات ويب RESTful ¹ لمنصات SaaS المستندة إلى السحابة، وبروتوكولات البيانات الوصفية للذكاء الاصطناعي التي تتيح لنظامك تلقي بيانات منظمة مثل أنواع المركبات والسمات البشرية مباشرةً من المعالج المدمج في الكاميرا.

وثائق SDK لدمج كاميرا PTZ في منصة الأمان

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

هل يمكنني الوصول إلى حزم تطوير البرمجيات (SDKs) C++ أو Python لدمجها بعمق في برنامجي المخصص؟

لقد عملت مع عملاء أضاعوا شهوراً في محاولة إجراء هندسة عكسية لبروتوكول الكاميرا لأن البائع لم يعطهم سوى عنصر تحكم ActiveX أساسي. لا ينبغي أن يحدث ذلك أبداً.

نعم، توفر الشركات المصنعة من الدرجة الصناعية مثل Loyalty-Secu حزم تطوير البرمجيات الأصلية C++ و C# للتكامل العميق. يمكنك أيضًا استخدام Python مكتبات عملاء ONVIF ² للنماذج الأولية السريعة. والأمر الأساسي هو أن تطلب من البائع حزم SDKs التي تتضمن نماذج من التعليمات البرمجية والمشاريع التجريبية ومراجع كاملة لواجهة برمجة التطبيقات - وليس مجرد ملف DLL مجرد.

C++ and Python SDK access for PTZ camera integration

لماذا لا تعتبر معظم “حزم تطوير البرمجيات” حزم تطوير برمجيات حقيقية

إليك شيئًا لن يخبرك به معظم البائعين. تقوم العديد من المصانع بشحن ما يسمونه SDK. ولكن عندما تفتح الحزمة، تجد ملف DLL واحدًا، وملفًا نصيًا موجزًا للقراءة، وربما عرضًا تجريبيًا واحدًا قديمًا مصممًا لنظام التشغيل Windows XP. في عام 2025، هذا عديم الفائدة. إذا كان النظام الأساسي الخاص بك يعمل على حاويات لينكس أو Docker، فإن DLL لا يفيدك بشيء.

تمنحك SDK الحقيقي تحكمًا كاملاً على مستوى المصدر. فهي تتيح للمطورين استدعاء وظائف محددة للكاميرا - مثل ضبط زاوية التحريك الدقيقة على 127.5 درجة، أو قراءة موضع التكبير/التصغير الحالي كقيمة رقمية. كما يتيح لك أيضًا سحب البيانات الوصفية للذكاء الاصطناعي من المعالج المدمج في الكاميرا. وهذا يعني أن النظام الأساسي الخاص بك يمكنه تلقي بيانات منظمة مثل “سيارة سيدان حمراء، تتحرك شمالاً، بسرعة 35 كم/ساعة” دون إجراء أي تحليل للفيديو على خادمك الخاص.

ما الذي تبحث عنه في حزمة SDK للموردين

عندما أقوم بتقييم بائع كاميرا جديد لأحد العملاء، أتحقق من هذه العناصر:

المكوّن	ما أهمية ذلك	العلم الأحمر إذا كان مفقوداً
SDK الأصلي (C++C/C#)	مطلوب لتطبيقات سطح المكتب أو الخوادم عالية الأداء	يقدم البائع عناصر تحكم ActiveX أو OCX فقط
مستندات RESTful API	ضروري للمنصات السحابية/منصات SaaS التي تستخدم مكالمات HTTP	لا توجد واجهة برمجة تطبيقات ويب API متاحة على الإطلاق
نموذج الرمز والتطبيق التجريبي	اختصار وقت التطوير من أشهر إلى أسابيع	ملف PDF فقط مع أسماء الدوال، لا يوجد رمز عملي
دليل بروتوكول البيانات الوصفية للذكاء الاصطناعي	يتيح لنظامك تلقي بيانات التحليلات المنظمة	الكاميرا تعمل بالذكاء الاصطناعي ولكن لا يمكنها تصدير النتائج
دعم المنصات المتعددة	قد تعمل خوادمك بنظام لينكس وليس ويندوز فقط	تعمل SDK على نظام التشغيل Windows 7/10 فقط

مكتبات عميل ONVIF يمكنك استخدامها الآن

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

• C# / .NET: شاربونفيف على GitHub يمنحك تطبيقًا كاملًا لعميل وخادم ONVIF. يدعم جميع الملفات الشخصية ويتضمن SimpleOnvifClient غلاف للاكتشاف والتكوين والبث السريع.
• بايثون: عميل onvif-client على PyPI يوفر WS-Discovery وعميل كاميرا بسيط. لمزيد من التحكم، جرّب onvif-py3, وهو عبارة عن شوكة Python 3 مع مساعدين لخدمات الأجهزة والوسائط والأحداث وخدمات PTZ.

تعمل هذه المكتبات مع أي كاميرا متوافقة مع ONVIF. لذا، حتى لو كنت تمزج بين كاميرات Axis و Hanwha و Reolink و Loyalty-Secu في مشروع واحد، فإن منطق النظام الأساسي الخاص بك يبقى كما هو. تكتبها مرة واحدة، وتتحدث معها جميعًا.

في Loyalty-Secu، نذهب إلى أبعد من ذلك. فنحن نوفر مجموعة أدوات تطوير البرمجيات C++K كاملة بالإضافة إلى طبقة RESTful API. وهذا يعني أنه يمكن لفريق ديفيد اختيار الأداة المناسبة لكل جزء من أجزاء منصتهم. استخدام SDK الأصلي لخط أنابيب الفيديو عالي السرعة. استخدم REST API للوحة تحكم الويب. كلاهما يتحدثان إلى نفس الكاميرا.

هل يوجد دليل API شامل للتحكم في تكبير العدسة والتركيز البؤري؟

كان لديّ عميل ذات مرة أمضى مطوّره أسبوعين في محاولة معرفة تنسيق أمر التكبير/التصغير لأن “دليل” البائع كان عبارة عن ملف PDF من 3 صفحات بلغة إنجليزية غير مفهومة. كاد ذلك المشروع أن يفوت الموعد النهائي.

نعم، يجب على الشركة المصنعة لكاميرا PTZ الاحترافية توفير دليل كامل لواجهة برمجة التطبيقات (API) يغطي تحديد المواقع المطلق والتكبير المستمر والتحكم في التركيز وإدارة الإعداد المسبق. يجب أن يتضمن الدليل أمثلة على طلبات HTTP ونطاقات المعلمات ورموز الإرجاع وعينة من التعليمات البرمجية الواقعية لكل وظيفة.

دليل API للتحكم في تكبير عدسة كاميرا PTZ والتركيز البؤري

الأنواع الثلاثة للواجهات البينية التي يجب أن يهتم بها ديفيد

عندما تقوم ببناء منصة أمان تتحكم في كاميرات PTZ، لا تتساوى جميع مكالمات واجهة برمجة التطبيقات (API). بعضها جميل أن يكون لديك. والبعض الآخر حاسم. اسمحوا لي أن أقوم بتفصيل الفئات الثلاث الأكثر أهمية.

1. التحكم في الوقت الحقيقي PTZ

هذا هو جوهر أي تكامل PTZ. تحتاج منصتك إلى إرسال أوامر مثل “التحريك لليسار 10 درجات” أو “التكبير إلى 20X” أو “الانتقال إلى الإعداد المسبق 5”. ولكن إليك التفصيل الذي يفوت معظم الناس: أنت بحاجة إلى التموضع المطلق, وليس فقط الحركة النسبية.

يعني التموضع المطلق أنه يمكنك أن تقول للكاميرا “انتقل إلى التحريك 185.0 درجة، والإمالة -12.5 درجة، والتكبير 25X” وستنتقل إلى هناك على الفور. هذا ما يجعل التحكم القائم على الخريطة ممكنًا. ينقر المشغّل على نقطة على خريطة نظام المعلومات الجغرافية، ويقوم برنامجك بحساب الزاوية، وتلتقط الكاميرا هذا الموضع بالضبط. بدون التحديد المطلق للموقع، سيتعطل المشغّل لديك باستخدام عناصر تحكم بنمط عصا التحكم، وهو بطيء وغير دقيق.

2. التكامل الصوتي

إذا كان مشروعك يتضمن مواقع البناء أو المستودعات أو الأمن المحيطي، فإن الصوت ثنائي الاتجاه ليس اختيارياً. يجب أن يوثق دليل واجهة برمجة التطبيقات الخاص بك كيفية إرسال واستقبال تدفقات الصوت. ابحث عن دعم ترميز AAC أو G.711. يجب أن تتيح لك واجهة برمجة التطبيقات (API) دفع مقطع صوتي إلى مكبر صوت الكاميرا أو سحب تغذية الميكروفون إلى منصتك.

3. إدارة التهيئة

هذا هو الجزء الذي ينساه معظم الناس حتى يوم النشر. هل يمكن لمنصتك تغيير إعدادات 4G APN للكاميرا عن بُعد؟ هل يمكنها ضبط عتبات إدارة الطاقة الشمسية - مثل ضبط الكاميرا على إيقاف التشغيل التلقائي عند 15% للبطارية؟ هل يمكنها تحديث البرنامج الثابت عبر الشبكة؟

هذه ليست أشياء يغطيها ONVIF بشكل جيد. أنت بحاجة إلى واجهة برمجة التطبيقات الخاصة بالبائع لهذا المستوى من التحكم. وهذا هو بالضبط سبب أهمية اختيار الشركة المصنعة التي تمتلك مجموعة برمجيات SDK حقيقية.

فئة واجهة برمجة التطبيقات	الوظائف الرئيسية	البروتوكول
التحكم في PTZ	الموضع المطلق، والتحرك المستمر، والاستدعاء المسبق، وإدارة الجولات	خدمة ONVIF PTZ أو واجهة برمجة تطبيقات HTTP الخاصة بالبائع
الصوت	التحدث في اتجاهين، والبث، وتشغيل المقاطع الصوتية	واجهة برمجة تطبيقات HTTP للبائع (AAC/G.711)
إدارة التهيئة	إعداد 4G APN، وعتبة الطاقة الشمسية، وتحديث البرامج الثابتة، وإعادة التشغيل	واجهة برمجة تطبيقات REST API الخاصة بالمورّد

في Loyalty-Secu، يغطي دليل واجهة برمجة التطبيقات لدينا جميع الفئات الثلاث. تتضمن كل دالة تنسيق طلب HTTP، ومثالاً على تجعيد الشعر، واستجابة JSON المتوقعة، ورموز الخطأ. نوفر أيضًا مجموعة ساعي البريد ³ حتى يتمكن المطورون لديك من اختبار كل نقطة نهاية في دقائق وليس أيام.

كيف أحصل على الدعم الفني إذا وجد المطورون لديّ خطأ في SDK؟

لقد كنت على الجانب الآخر من هذه المشكلة. فقد وجد مطور أحد العملاء تسربًا في الذاكرة في مجموعة تطوير البرمجيات SDK الخاصة بأحد البائعين، وأرسل تذكرة وانتظر 6 أسابيع للحصول على رد. بحلول ذلك الوقت، كان المشروع متأخرًا بالفعل عن الجدول الزمني وكان العميل غاضبًا.

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

الدعم الفني للإبلاغ عن أخطاء SDK وحلها

لماذا تفشل قنوات الدعم العامة في حل مشاكل SDK

أخطاء SDK ليست مثل تذاكر دعم “الكاميرا غير متصلة”. فهي تتطلب معرفة تقنية عميقة. يحتاج وكيل الدعم إلى فهم التعليمات البرمجية الخاصة بك، وإعادة إنتاج المشكلة في بيئة اختبار، والتنسيق مع فريق البرامج الثابتة لدفع الإصلاح. لا يمكن لوكيل دعم من المستوى الأول يقرأ من برنامج نصي القيام بذلك.

لهذا السبب دائماً ما أقول لعملائي أن يسألوا سؤالاً واحداً قبل اختيار البائع: “إذا عثر مطوري على خطأ في مجموعة أدوات تطوير البرمجيات الخاصة بك، إلى من سأتحدث - إلى وكيل دعم أم إلى مهندس؟”

كيف يبدو دعم SDK الجيد

إليك ما نقوم به في Loyalty-Secu لكل مشروع تكامل:

• مهندس مخصص: نقوم بتعيين مهندس واحد من فريق البحث والتطوير لدينا لمشروعك. يعرف هذا الشخص مجموعة تطوير البرمجيات SDK من الداخل والخارج. يتحدث المطور الخاص بك إليهم مباشرةً على واتساب أو Teams أو البريد الإلكتروني.
• بيئة تكاثر الحشرات: عندما يبلغ مطور البرامج عن خطأ ما، يقوم مهندسنا بإعادة إنتاجه على نفس الجهاز وإصدار البرنامج الثابت. بدون تخمين.
• توصيل الرقعة: بالنسبة للأخطاء المؤكدة في SDK، نقوم بتسليم مجموعة أدوات تطوير البرمجيات SDK أو البرامج الثابتة المصححة في غضون 7 إلى 14 يوم عمل. أما بالنسبة للمشكلات الحرجة (مثل أخطاء الأعطال)، نقوم بتصعيدها إلى 48 ساعة.
• التحكم في الإصدار: يحتوي كل إصدار SDK على سجل تغييرات. أنت تعرف دائمًا ما الذي تغير ولماذا.

ما الذي يجب أن تسأل البائع قبل التوقيع؟

قبل الالتزام بأي بائع كاميرا لمشروع تكامل النظام الأساسي، اطرح هذه الأسئلة:

1. هل يمكنني الحصول على اتصال مباشر مع مهندس SDK الخاص بكم؟
2. ما هو متوسط وقت استجابتكم لتقارير أخطاء SDK؟
3. هل توفرون برنامجًا ثابتًا مرحليًا للاختبار قبل طرح الإنتاج؟
4. كم مرة تقومون بتحديث SDK، وهل تحافظون على التوافق مع الإصدارات السابقة؟

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

هل تدعم SDK بيئتي ويندوز ولينكس على حد سواء للتطبيق من جانب الخادم الخاص بي؟

لقد قابلت مطورين قاموا ببناء الواجهة الخلفية بالكامل على Ubuntu، ليكتشفوا أن مجموعة تطوير البرمجيات SDK للكاميرا التي اختاروها تعمل فقط على نظام Windows. هذا اكتشاف قاتل للمشروع في أسوأ وقت ممكن.

نعم، يجب أن تدعم حزم SDK الاحترافية كلاً من ويندوز ولينكس. نحن في Loyalty-Secu، نوفر مكتبات أصلية لأنظمة ويندوز (DLL) ولينكس (SO) وأندرويد و iOS. للتطبيقات من جانب الخادم التي تعمل في دوكر ⁴ أو Kubernetes ⁵, ، تعمل طبقة RESTful API الخاصة بنا على أي نظام تشغيل دون تثبيت برامج تشغيل محلية.

واقع المنصة في عام 2025

لا تعمل معظم المنصات الأمنية الجادة اليوم على سطح مكتب ويندوز واحد. فهي تعمل على بيئات مختلطة. قد يكون خادم تسجيل الفيديو Ubuntu مع Docker. قد تكون الواجهة الأمامية للويب تطبيق React يتم تقديمه من Nginx. تطبيق الجوال على أندرويد وiOS. قد يكون محرك التحليلات عبارة عن خدمة Python تعمل في جراب Kubernetes.

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

كيف نحل المشاكل عبر المنصات المتعددة في شركة Loyalty-Secu

نوفر مسارين للتكامل:

مسار التكامل	الأفضل لـ	دعم المنصة	الميزة الرئيسية
مجموعة تطوير البرمجيات الأصلية (مكتبات C++C/C#)	خط أنابيب فيديو عالي الأداء، تسجيل محلي	ويندوز (.dll)، لينكس (.so)	أقل زمن انتقال، وصول كامل للأجهزة
واجهة برمجة تطبيقات RESTful Web API	لوحات المعلومات السحابية، ومنصات SaaS، وتطبيقات الأجهزة المحمولة	أي نظام تشغيل (قائم على HTTP)	لا يوجد برنامج تشغيل مثبت، يعمل في Docker/K8s

تفاصيل SDK الأصلية

على نظام التشغيل Windows، تكون DLL قياسية. على لينكس، هو ملف .so. يعرض كلا الإصدارين نفس سطح واجهة برمجة التطبيقات. يكتب مطوروك نفس التعليمات البرمجية على كلا النظامين الأساسيين. نقوم بتضمين نصوص إنشاء CMake البرمجية ⁶ لنظام لينكس وملفات مشروع Visual Studio لنظام ويندوز.

تغطي مجموعة أدوات تطوير البرمجيات:

• فك تشفير الفيديو المباشر وعرضه
• التحكم المطلق والنسبي PTZ
• الاشتراك في البيانات الوصفية للذكاء الاصطناعي (تلقي نتائج اكتشاف الكائنات في الوقت الفعلي)
• إرسال الصوت واستقباله
• تكوين الجهاز (الشبكة، التخزين، 4G، إعدادات الطاقة الشمسية)

تفاصيل واجهة برمجة تطبيقات RESTful API

بالنسبة للفرق التي تفضل التكامل المستند إلى HTTP، نعرض كل وظيفة كاميرا من خلال واجهة برمجة تطبيقات RESTful. يمكنك إرسال طلب POST لتحريك PTZ. يمكنك إرسال طلب GET لقراءة الموقع الحالي. يمكنك الاشتراك في نقطة نهاية WebSocket لتلقي أحداث اكتشاف الذكاء الاصطناعي في الوقت الفعلي.

هذا النهج مثالي لفريق ديفيد إذا كانوا يقومون ببناء منصة SaaS قائمة على السحابة. ليست هناك حاجة لتثبيت أي برنامج تشغيل أو مكتبة على الخادم. يمكن لأي لغة يمكنها تقديم طلبات HTTP - Python و Node.js و Go و Java و Ruby - التحكم في الكاميرا.

ONVIF كاحتياطي عالمي

حتى إذا كنت لا تستخدم SDK الخاص بنا، يمكنك دائمًا الرجوع إلى ONVIF Profile S. يمنحك هذا بث فيديو محايد من البائع، والتحكم في PTZ، واكتشاف الجهاز. لقد أدرجت أفضل مكتبات عملاء ONVIF في وقت سابق في هذه المقالة. إنها تعمل على كل من ويندوز ولينكس، وتتحدث إلى أي كاميرا متوافقة مع ONVIF من أي علامة تجارية.

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

الخاتمة

تحدد جودة SDK ما إذا كان تكاملك يستغرق أسبوعين أو ستة أشهر. اسأل عن حزم SDK الأصلية وواجهات برمجة تطبيقات RESTful API وعينات من التعليمات البرمجية والدعم المباشر للبحث والتطوير - قبل أن تلتزم بأي بائع كاميرا.

---

1. مواصفات OpenAPI الرسمية لمعايير تصميم واجهة برمجة تطبيقات RESTful API. ︎ 2. مكتبة Python لعميل ONVIF Python للنماذج الأولية للتكامل السريع للكاميرا. ︎ 3. منصة اختبار Postman API للتحقق من صحة نقاط نهاية الكاميرا. ︎ 4. منصة حاويات Docker لنشر الخوادم عبر المنصات. ︎ 5. تزامن Kubernetes لمنصة Kubernetes من أجل دعم منصة الأمان القابلة للتطوير. ︎ 6. نظام بناء CMake لتجميع مشاريع C+++C عبر المنصات. ︎ 7. معيار ONVIF Profile S الرسمي لـ PTZ وبث الفيديو. ︎ 8. مستودع GitHub لمكتبة عميل SharpOnvif C#/.NET. ︎ 9. بروتوكول WebSocket لبث البيانات الوصفية للذكاء الاصطناعي في الوقت الحقيقي. ︎ 10. أفضل الممارسات لإصدار SDK المستند إلى Git وصيانة سجل التغيير. ︎