> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/input-output/image-inputs/irayple-camera.md).

# Irayple Camera

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

هذا البلوك لا يتطلب أية مدخلات.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Image` أحدث إطار تم التقاطه من كاميرا Irayple.

`Is Active` علم منطقي (Boolean) يشير إلى ما إذا كانت الكاميرا تبث حالياً أم لا.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Serial Number` أدخل معرف السيريال الخاص بالكاميرا كما هو مطبوع على جهاز Irayple. مثال للصيغة: AB12345XYZ00009.

* اترك هذا الحقل فارغاً لقطع الاتصال بالكاميرا وإيقاف البث.
* عند إدخال سيريال صالح، سيحاول البلوك الاتصال تلقائياً.

كيف يتصرف البلوك: عندما يكون هناك سيريال صالح، سيحاول البلوك الاتصال ويبدأ في إنتاج إطارات على مخرج `Image` بينما يقوم بتحديث حالة `Is Active`. مسح السيريال يفصل الاتصال ويوقف المخرجات.

## 🎨 الميزات <a href="#features" id="features"></a>

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

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. أدخل رقم السيريال في حقل `Serial Number` بصيغة المطبوعة على الجهاز (مثال: AB12345XYZ00009).
2. انتظر لحظة حتى يقيم البلوك الاتصال. سيصبح `Is Active` True عند بدء البث.
3. استخدم مخرج `Image` كمصدر الصورة الحي لباقي البلوكات (مثل الكشف، التحليل، التسجيل، إلخ).
4. لإيقاف البث، امسح حقل `Serial Number` — سيقوم البلوك بفصل الاتصال وسيصبح `Is Active` False.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* لمعاينة سريعة، وصل مخرج `Image` إلى بلوك `Show Image` لتأكيد محاذاة الكاميرا والتعرض قبل إضافة بلوكات المعالجة.
* احفظ إطارات أو تسجيلات بتوصيل `Image` إلى `Image Logger` أو `Image Write` أو `Record Video` عند الحاجة لمجموعة بيانات أو دليل.
* في سير عمل الكشف أو التقدير، قدّم `Image` إلى بلوكات الكشف مثل `Object Detection`, `Object Detection - Custom`, `Mask Detection`, `Pose Estimation` أو `Skeleton Estimation`.
* استخدم `Image Resizer` قبل البلوكات الثقيلة (مثال: `Depth Estimation (DepthAny. V2)` أو `Object Detection (D-FINE)`) لتقليل زمن المعالجة واستهلاك الذاكرة.
* إذا احتجت معايرة منظور للمسافات أو الخرائط، استخدم `Perspective Transform` ثم مرّر مصفوفة التحويل إلى بلوكات مثل `Social Distance Detector`.
* اقص أو ركز على منطقة الاهتمام باستخدام `Image ROI` أو `Image ROI Select` قبل الكشف لتقليل الإيجابيات الكاذبة وتسريع المعالجة.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* لا يوجد اتصال أو لا يمكن البث:
  * تحقق أن السيريال الذي أدخلته يطابق تماماً المعرف الموجود على الكاميرا.
  * تأكد أن الكاميرا متصلة ومغذاة ويمكن الوصول إليها عبر الشبكة.
  * إذا لزم الأمر، ثبّت SDK أو التعريفات الموصى بها من شركة الكاميرا (راجع دعم البائع).
  * استخدم بلوك `Show Image` للتحقق مما إذا كانت الإطارات تصل.
* إطارات متقطعة أو متجمدة:
  * امسح السيريال وأعد إدخاله لإجبار إعادة الاتصال.
  * تحقق من استقرار الشبكة وإصدار برنامج الكاميرا.
  * إذا ظهرت إطارات فارغة متكررة، حاول تخفيف حمل المعالجة اللاحقة (استخدم `Image Resizer`) أو خفّض دقة الكاميرا إن أمكن.
* حجم الإطار كبير جداً للمعالجات اللاحقة:
  * أضف بلوك `Image Resizer` مباشرة بعد مخرج `Image` لتقليل الدقة قبل بلوكات التحليل الثقيلة.

للفحص البصري السهل، وصل إلى `Show Image`؛ وللتسجيل اختر `Image Logger` أو `Record Video`. استخدم بلوكات التحليل المذكورة أعلاه لبناء تدفقات كشف أو قياس أو مراقبة من البث الحي.