Stream Reader

هذا الـ function block يقوم بتشغيل تدفقات الشبكة (YouTube، Twitch، HTTP/RTSP وما شابه) في الخلفية ويحتفظ بأحدث إطار جاهزًا للاستهلاك من قِبل بقية البلوكات. تم تصميمه للمعاينة المستمرة للتدفق والمعالجة اللاحقة مع عناصر تحكم لسرعة التشغيل، الجودة المطلوبة، وتحديد حد معدل الإطارات.

📥 المدخلات

هذا الـ function block لا يحتوي على مدخلات.

📤 المخرجات

Image Any أحدث إطار تم استرجاعه من مصدر البث المزوّد (يتحدّث باستمرار أثناء تشغيل التدفق).

🕹️ الضوابط (Controls)

Status يعرض الحالة الحالية ورسائل مفيدة (مثل: waiting, connecting, live, paused, reconnecting).

Stream URL أدخل عنوان أو رابط التدفق الذي تريد تشغيله (أمثلة: روابط البث العامة، HTTP livestreams، أو روابط المزود).

Playback speed اضبط معدل التشغيل (النطاق يظهر في واجهة المستخدم). استخدم قيم أقل من 1.0 للحركة البطيئة أو أعلى من 1.0 للتشغيل الأسرع.

Preferred quality اطلب جودة مفضلة للتدفق عندما تتوفر نسخ متعددة (مثال: Best، 1080p، 720p).

FPS limit حدد حدًا لمعدل الإطارات الصادرة من هذا البلوك. اضبطه على 0 لاستخدام معدل الإطارات الأصلي للمصدر.

Pause playback مفتاح للتوقيف المؤقت/المتابعة للتدفق دون إغلاق الاتصال.

🎨 الميزات (Features)

• تشغيل في الخلفية: يقوم بتشغيل التدفقات البعيدة في عملية خلفية حتى تظل واجهة المستخدم سريعة مع الاحتفاظ بأحدث إطار متاح.

• تعامل متين مع الاتصال: يعرض رسائل حالة واضحة (connecting, live, paused, reconnecting) ويحاول التعافي من الأخطاء العابرة.

• تحكم في التشغيل: تحكم بسرعة التشغيل واطلب تمثيلًا معينًا عند توفره.

• تحديد معدل الإطارات: خفّض الحمل اللاحق بتحديد سقف للإطارات في الثانية.

• رفع إطارات اختيارية عن بعد: عند التهيئة، يمكن إرسال الإطارات الملتقطة إلى ناقل رفع عن بُعد للتخزين أو التسجيل.

• إيقاف مؤقت دون فقدان الإطار الأخير: الإيقاف المؤقت يحتفظ بآخر إطار متاح للتفتيش أو المعالجة.

📝 تعليمات الاستخدام (Usage)

1. أدخل رابط البث في Stream URL.

2. اضبط Preferred quality إذا أردت تمثيلًا معينًا.

3. حدّد Playback speed و FPS limit للتحكم في كيفية تسليم التدفق إلى البلوكات التالية.

4. استخدم Pause playback لإيقاف تحديثات الإطارات مؤقتًا مع الحفاظ على الاتصال.

5. قم بتوصيل مخرج هذا البلوك Image Any إلى بلوكات العرض أو المعالجة لاستهلاك الإطارات الحية.

📊 التقييم (Evaluation)

عند التنشيط، يقوم هذا الـ function block بجلب إطارات بشكل مستمر من التدفق المُكوَّن ويوفر أحدث إطار عبر المخرج Image Any. تتحدّث رسائل الحالة لتعكس حالة الاتصال. عند التوقيف المؤقت، تتوقف تحديثات الإطارات لكن يبقى آخر إطار متاحًا.

💡 نصائح وحيل (Tips and Tricks)

• لمعاينة البث تفاعليًا، قم بتوصيل المخرج Image Any إلى بلوك Show Image لفتح عارض الصور وفحص الإطارات.

• خفّض حمل CPU/GPU بتوصيل Image Any إلى بلوك Image Resizer قبل البلوكات الثقيلة على الـ AI مثل Object Detection (D-FINE), Mask Detection, Pose Estimation.

• للتسجيل طويل الأمد أو التصحيح، مرر المخرج إلى Record Video, Image Logger أو Image Write.

• استخدم Background Subtractor على مخرج التدفق لاكتشاف الحركة أو استخراج مناطق المقدمة للمتنبِّهات اللاحقة (مثلاً Object Detection - Custom).

• إذا رغبت بالتركيز على منطقة معينة من المشهد، استخدم Image ROI, Image ROI Select أو Image ROI Polygon قبل بلوكات الكشف أو القياس (مثل Find Object أو Histogram On Line).

• اجمع مع Object_Detection_Tracker و Draw Detections لتتبع وتصوير الكائنات المكتشفة عبر الإطارات من التدفق.

• للـ OCR على البث المباشر، وصل المخرج إلى OCR أو OCR (EasyOCR) بعد قص مناسب (Image ROI Select) وتحسين الصورة (Contrast Optimization أو Denoising).

• إذا كان مصدر التدفق كبيرًا أو غير مستقر، جرّب تقليل FPS limit أو خفض Preferred quality لتحسين الاستقرار وتقليل استهلاك النطاق الترددي.

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

• إذا أظهرت الحالة "Waiting for stream link"، تأكد أن Stream URL عبارة عن رابط كامل يتضمن البروتوكول (مثال: http://, https://, rtsp://).

• إذا فشل الاتصال أو أعاد الاتصال بشكل متكرر، جرّب خفض الجودة المطلوبة أو تقليل حد الإطارات لتخفيف النطاق والتحميل.

• إذا توقفت الإطارات عن التحديث بينما تظهر الحالة live، قم بإيقاف ثم تفعيل Pause playback لإجبار تحديث.

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