For the complete documentation index, see llms.txt. This page is also available as Markdown.

Camera IP

هذا الدالة (function block) تقرأ تيارات الكاميرا عبر RTSP/HTTP في خيط عمل خلفي (background thread) وتبقي الإطار الأخير جاهزًا مع أقل استهلاك ممكن للمعالج CPU. صُممت للمراقبة الحية ولتغذية كتل معالجة الصور بشكل موثوق حتى عند حدوث انقطاعات شبكية.

📥 المدخلات

هذه الدالة ليس لها مدخلات.

📤 المخرجات

Image الإطار الحالي المستخرج من كاميرا الـ IP المكونة.

🕹️ عناصر التحكم

Status — يعرض حالة الاتصال الحالية (مثل: Waiting for camera link, Connecting..., Live, Reconnecting...).

Camera link — ألصق رابط RTSP/HTTP الكامل للكاميرا (مثال: rtsp://camera-ip/stream).

Username — اسم المستخدم إذا كانت الكاميرا تتطلب مصادقة.

Password — كلمة المرور إذا كانت الكاميرا تتطلب مصادقة.

(تنبيه) بعد تعديل Camera link أو بيانات الاعتماد، ينتظر البلوك لحظة قصيرة قبل إعادة الاتصال حتى تتمكن من إكمال الكتابة.

🎯 الميزات الرئيسية

  • قارئ في خلفية ثُريد (background threaded reader) يحافظ على الإطار الأحدث متاحًا للكتل التالية مع استهلاك منخفض للمعالج.

  • يدعم روابط RTSP و HTTP مع خيار المصادقة بـ Username/Password.

  • تحديثات حالة تلقائية لعرض تقدم الاتصال والمشاكل.

  • إعادة اتصال تلقائية مع تأخيرات متزايدة عند الفشل.

  • يحتفظ بآخر إطار ناجح متاحًا أثناء محاولات إعادة الاتصال.

  • إمكانية رفع الإطارات في الخلفية إلى خدمة بعيدة إذا تم تهيئتها.

⚙️ كيفية التشغيل

  • أدخل رابط كاميرا صالح في Camera link (ومع بيانات الاعتماد إذا لزم الأمر).

  • سيحاول البلوك الاتصال في الخلفية ويحدّث Status.

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

  • عند مشاكل الاتصال يعرض البلوك رسائل حالة ويقوم بمحاولات إعادة اتصال تلقائية؛ يبقى آخر إطار صالح متاحًا حتى يستلم إطارًا جديدًا.

📝 إرشادات الاستخدام

  1. أدخل عنوان الكاميرا في Camera link.

  2. إذا كانت الكاميرا تتطلب مصادقة، عبِّئ Username و Password.

  3. انتظر حتى يظهر Status بحالة Live/Connected.

  4. وصل مخرج Image إلى كتل المعالجة أو العرض التالية.

الكتل المقترحة للاستخدام اللاحق:

  • استخدم Show Image لمعاينة الإطارات.

  • استخدم Image Resizer أو Image Resize لتقليل حجم الإطار قبل المعالجة إن لزم.

  • استخدم Record Video أو Image Logger لحفظ الإطارات أو التسجيلات.

  • غذِِّ النتائج إلى كتل الذكاء الاصطناعي/التحليل مثل Object Detection, Object Detection - Custom, Pose Estimation, أو Mask Detection للاستدلال الحي.

  • استخدم Image ROI Select / Image ROI Polygon / Image ROI Polygon Multi لاقتطاع أو تحديد منطقة المعالجة قبل الكشف.

  • استخدم Background Removal (RMBG-1.4) أو Background Removal (BiRefNet) لاستخراج المقدمة إذا لزم.

  • اجمع مع Object_Detection_Tracker للحفاظ على الهويات عبر الإطارات.

💡 نصائح وحيل

  • إذا كانت الكاميرا تدعم ONVIF وتفضل لقطات متفرقة بدلًا من تيار مستمر، جرب Camera IP (ONVIF).

  • لتسريع خط المعالجة، خفّض الدقة في إعدادات الكاميرا.

  • للتحقق من الاتصال، جرّب نفس الرابط في مشغل خارجي مثل VLC وتأكد من صحة بيانات الاعتماد.

  • استخدم Show Image للتأكد من محتوى الإطار قبل توجيهه إلى كتل الكشف أو التسجيل.

  • عند تسجيل جلسات طويلة، يفضّل استخدام Record Video بدل حفظ العديد من الصور المفردة؛ استخدم Image Logger للحفظ الانتقائي.

  • عند الحاجة لتحليل أجزاء فقط من المشهد، اقتطع باستخدام Image ROI Select أو حدّد مناطق متعددة بـ Image ROI Polygon Multi لتقليل الإيجابيات الكاذبة وتسريع المعالجة.

  • اجمع مع Object Detection (أو Object Detection - Custom) ثم مع Object_Detection_Tracker لتطبيقات التتبع والعدّ المراقبة (مثلاً تغذية النتائج إلى Traffic Intersection Analysis).

🛠️ استكشاف الأخطاء وإصلاحها

  • لا يوجد اتصال / الحالة متوقفة على waiting: تحقق من أن رابط الكاميرا صحيح ويمكن الوصول إليه عبر الشبكة. جرّب البث في مشغل خارجي.

  • أخطاء مصادقة: تأكد من صحة Username و Password وأعد إدخالهما.

  • إطارات متقطعة أو إعادة اتصال متكررة: قد تكون مشكلة في الشبكة أو الكاميرا؛ سيحاول البلوك إعادة الاتصال تلقائيًا. فكّر في شبكة أكثر استقرارًا أو تسجيل محلي إذا لزم.

  • إطارات فارغة أو غير مدعومة: استخدم Show Image لفحص المخرج. إذا أفاد العرض بأن البيانات غير مدعومة، جرّب صيغة بث مختلفة أو استخدم رابط موصى به من بائع الكاميرا.

  • استهلاك عالي للمعالج: إذا كانت المعالجة التالية مكثفة، خفّض الدقة بواسطة Image Resizer أو عالج الإطارات بمعدل أقل عبر منطق تقييد التدفق.

إذا احتجت واجهة كاميرا مختلفة (USB، برامج تشغيل كاميرا مخصصة، أو لقطات ONVIF)، تحقق من كتل إدخال الصورة المقابلة مثل Camera USB أو Camera IP (ONVIF) لتطابق العتاد وتدفق العمل لديك.

آخر تحديث