واجهة برمجة تطبيقات كاميرا الجسم
توفر واجهة برمجة التطبيقات (API) الخاصة بكاميرا Shelleyes 4G المثبتة على الجسم (S7P/S4) واجهة تكامل مفتوحة تتيح لمنصات وأنظمة البرمجيات والتطبيقات التابعة لأطراف ثالثة التواصل مع كاميرات Shelleyes 4G المثبتة على الجسم.
توفر واجهة برمجة تطبيقات (API) كاميرات الجسم واجهة اتصال آمنة بين كاميرات الجسم التي تعمل بتقنية 4G ومنصات الجهات الخارجية.
من خلال واجهة برمجة التطبيقات (API) هذه، يمكن للمطورين دمج كاميرات الجسم مع منصاتهم الخاصة، بما في ذلك:
- أنظمة إدارة الفيديو (VMS)
- أنظمة إدارة الأدلة الرقمية (DEMS)
- منصات قيادة السلامة العامة
- تطبيقات المراقبة المخصصة
تدعم واجهة برمجة التطبيقات (API) ما يلي:
- تسجيل الأجهزة وإدارتها
- التحكم في الكاميرا عن بُعد
- التتبع عبر نظام تحديد المواقع العالمي (GPS) في الوقت الفعلي
- البث المباشر للفيديو والصوت
تتألف بنية الاتصالات من ثلاث قنوات بيانات مستقلة:
| قناة البيانات | الوصف |
|---|---|
| بيانات التحكم | تسجيل الجهاز، وإشارة النبض، ومراقبة الحالة، والأوامر عن بُعد |
| بيانات نظام تحديد المواقع العالمي (GPS) | معلومات الموقع في الوقت الفعلي التي تم تحميلها من الجهاز |
| بيانات الفيديو/الصوت (RTMPS) | البث المباشر للفيديو والصوت |
تستخدم جميع قنوات الاتصال نظام نقل آمن مع تشفير TLS.
بنية اتصالات واجهة برمجة التطبيقات (API)
تتواصل كاميرا الجسم مع الخادم عبر قنوات اتصال مخصصة.
| قناة البيانات | منفذ الخادم | البروتوكول |
|---|---|---|
| بيانات التحكم | 1901 | بروتوكول TCP عبر TLS |
| بيانات نظام تحديد المواقع العالمي (GPS) | 7095 | بروتوكول TCP عبر TLS |
| بيانات الفيديو/الصوت (RTMPS) | 1935 | RTMPS |
تستخدم قناة بث الفيديو/الصوت بروتوكول RTMPS (RTMP عبر TLS)، مما يوفر نقلًا مشفرًا للوسائط في الوقت الفعلي بين الكاميرا المثبتة على الجسم والخادم.
1. بيانات التحكم
لمحة عامة
تعد «بيانات التحكم» القناة الرئيسية للاتصال بين كاميرا الجسم والخادم.
وهي مسؤولة عن:
- تسجيل الجهاز
- التواصل عبر نبضات القلب
- تنفيذ الأوامر عن بُعد
- الاستعلام عن حالة الجهاز
- ردود الفعل على الأوامر
يستخدم نظام الاتصال الخاص بالتحكم بروتوكولاً خفيفاً قائماً على لغة JSON ولا يتطلب سوى الحد الأدنى من النطاق الترددي.
تكوين المنفذ
| القناة | منفذ الخادم | منفذ كاميرا الجسم |
|---|---|---|
| بيانات التحكم | 1901 | 1902 |
تسجيل الجهاز
عندما تتصل كاميرا الجسم بالشبكة، فإنها ترسل طلب تسجيل إلى الخادم.
تتضمن معلومات التسجيل ما يلي:
| الميدان | الوصف |
|---|---|
| IMEI | رقم تعريف الجهاز |
| ديفيد | معرّف الجهاز المحدد من قبل المستخدم |
| SW_VER | إصدار البرنامج الثابت |
| PROTO_VER | إصدار بروتوكول الاتصال |
| الطابع الزمني | الطابع الزمني بتوقيت UTC |
| AGENTID | معرّف مستخدم/مشغل الجهاز |
بعد إتمام التسجيل بنجاح، يوفر الخادم مفتاح جلسة يُستخدم لمصادقة الرسائل.
نبض القلب
بعد التسجيل، يرسل الجهاز رسائل «نبض» بشكل دوري للحفاظ على حالة الاتصال بالإنترنت.
يمكن أن تشمل معلومات نبضات القلب ما يلي:
- مستوى شحن البطارية
- سعة التخزين المتبقية
- قوة إشارة الشبكة
- حالة التسجيل
- حالة نظام تحديد المواقع العالمي (GPS)
الفاصل الزمني الافتراضي لنبضات التشغيل:
- كل 3 ثوانٍ
إذا لم يتلقَّ الخادم رسائل «نبض» لمدة 60 ثانية، فيمكن اعتبار الجهاز غير متصل بالإنترنت.
أوامر جهاز التحكم عن بُعد
يمكن للخادم إرسال أوامر للتحكم عن بُعد في كاميرا الجسم.
تشمل الأوامر المدعومة ما يلي:
| الأمر | الوظيفة |
|---|---|
| بدء بث الفيديو | بدء البث المباشر للفيديو |
| إيقاف بث الفيديو | إيقاف البث المباشر |
| بدء تسجيل الفيديو | بدء التسجيل المحلي |
| إيقاف تسجيل الفيديو | إيقاف التسجيل |
| بدء تحميل بيانات GPS | تمكين التحميل عبر نظام تحديد المواقع العالمي (GPS) |
| إيقاف تحميل بيانات GPS | تعطيل تحميل بيانات GPS |
| التقاط صورة | التقاط صورة عن بُعد |
| الاهتزاز | تشغيل اهتزاز الجهاز |
| الاستعلام عن البطارية | الحصول على معلومات البطارية |
| الاستعلام عن حالة الجهاز | الحصول على الحالة الحالية للجهاز |
يقوم الجهاز بإرجاع نتائج تنفيذ الأوامر عبر حقل CTRLFB.
2. بيانات نظام تحديد المواقع العالمي (GPS)
لمحة عامة
توفر بيانات نظام تحديد المواقع العالمي (GPS) معلومات عن الموقع في الوقت الفعلي من الكاميرا المثبتة على الجسم إلى الخادم.
وضع الاتصال بنظام تحديد المواقع العالمي (GPS) هو:
كاميرا الجسم → الخادم
يتم إرسال معلومات نظام تحديد المواقع العالمي (GPS) عبر قناة GPS مستقلة.
تكوين المنفذ
| القناة | منفذ الخادم |
|---|---|
| بيانات نظام تحديد المواقع العالمي (GPS) | 7095 |
تواتر تحميل بيانات نظام تحديد المواقع العالمي (GPS)
عند تمكين نظام تحديد المواقع العالمي (GPS):
- يقوم الجهاز بإرسال معلومات نظام تحديد المواقع العالمي (GPS) كل ثانيتين.
استخدام رسائل نظام تحديد المواقع العالمي (GPS):
MSGTYPE = 3ويتم إرسالها حصريًّا عبر قناة GPS.
حقول بيانات نظام تحديد المواقع العالمي (GPS)
تتضمن رسالة نظام تحديد المواقع العالمي (GPS) ما يلي:
| الميدان | الوصف |
|---|---|
| LAT | خط العرض |
| LON | خط الطول |
| السرعة | السرعة الحالية |
| الارتفاع | الارتفاع |
| العنوان | اتجاه الحركة |
| HDOP | مؤشر دقة نظام تحديد المواقع العالمي (GPS) |
| SAT_COUNT | عدد الأقمار الصناعية |
| GPS_VALID | حالة صلاحية نظام تحديد المواقع العالمي (GPS) |
| الطابع الزمني | الطابع الزمني بتوقيت UTC |
3. بيانات الفيديو/الصوت (RTMPS)
لمحة عامة
توفر واجهة برمجة التطبيقات (API) للفيديو والصوت إمكانية بث الفيديو والصوت في الوقت الفعلي بين كاميرا الجسم والمنصات الخارجية.
بروتوكول البث هو:
RTMPS (RTMP عبر TLS)
وهي تتيح البث المباشر الآمن للفيديو للتكامل مع:
- منصات VMS
- مراكز القيادة
- أنظمة المراقبة
- التطبيقات المخصصة
تكوين المنفذ
| القناة | منفذ الخادم |
|---|---|
| بيانات الفيديو/الصوت (RTMPS) | 1935 |
سير عمل البث المباشر
عملية البث المباشر:
1. يرسل الخادم أمر «بدء بث الفيديو»
↓
2. تستقبل كاميرا الجسم رسالة CTRLMSG = 0
↓
3. تبدأ الكاميرا البث عبر بروتوكول RTMPS
↓
4. يستقبل الخادم دفق الفيديو/الصوت المباشرتنسيق البث RTMPS
رابط البث:
rtmps://server_ip:1935/live/DEVID
يتم حماية اتصال البث من خلال التحكم في الوصول من جانب الخادم، بحيث لا يُسمح إلا باتصالات الأجهزة المسجلة.
ترميز الفيديو والصوت
فيديو
برامج الترميز المدعومة:
- H.264
- H.265
الصوت
برنامج الترميز المدعوم:
- AAC
خادم الوسائط الموصى به:
SRS (خادم بسيط يعمل في الوقت الحقيقي)
يمكن لبرنامج SRS تحويل تدفقات RTMPS إلى صيغ متوافقة مع الويب مثل:
- HLS
- WebRTC
للتشغيل عبر المتصفح.
الأمن
تشفير TLS
تدعم جميع قنوات الاتصال بروتوكول TLS 1.2 أو إصدارًا أحدث:
| القناة | الأمن |
|---|---|
| بيانات التحكم | بروتوكول TCP عبر TLS |
| بيانات نظام تحديد المواقع العالمي (GPS) | بروتوكول TCP عبر TLS |
| بيانات الفيديو/الصوت | RTMPS |
التحكم في الوصول إلى الدفق
تستخدم خدمة البث نظام التحكم في الوصول القائم على عناوين IP.
آلية الأمان:
- يقوم الخادم بتسجيل عنوان IP للجهاز أثناء التسجيل
- لا يمكن إقامة اتصالات البث إلا عبر عناوين IP للأجهزة المسجلة
- يقوم الخادم بالتحقق من هوية الجهاز قبل قبول التدفقات
لا يلزم وجود رمز بث إضافي.
توثيق الرسائل
استخدام رسائل التحكم ورسائل GPS:
HMAC-SHA256
ميزات الأمان:
- المصادقة باستخدام مفتاح الجلسة
- تغيير المفتاح كل 24 ساعة
- الحماية من إعادة التشغيل باستخدام الرقم التسلسلي
سير عمل التكامل
عملية التكامل النموذجية:
تتصل كاميرا الجسم بالشبكة
↓
تسجيل الجهاز
↓
مصادقة الخادم
↓
اتصال «هارتبيت»
↓
التحكم عن بُعد بالأوامر
↓
تحميل بيانات GPS / البث المباشر عبر RTMPS
↓
التكامل مع منصات الجهات الخارجيةتطبيقات التكامل المدعومة
يمكن دمج واجهة برمجة تطبيقات (API) كاميرا الجسم في:
حلول البرمجيات المخصصة
منصات VMS
منصات السلامة العامة
أنظمة المراقبة الأمنية