> 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/camera-usb-external.md).

# Camera USB External

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

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

`Activate Signal` استخدم هذا البوليان لبدء استرجاع الإطارات من الكاميرا المحددة.

`Release Signal` استخدم هذا البوليان لإيقاف الكاميرا وتحرير مواردها.

`Camera Index` قدم عددًا صحيحًا لاختيار جهاز الكاميرا (فهرس الجهاز أو تعيين الفهرس الممسوح).

`Resolution Width` قدم عددًا صحيحًا لعرض الالتقاط المطلوب.

`Resolution Height` قدم عددًا صحيحًا لارتفاع الالتقاط المطلوب.

`Scan Cameras` اضبط إلى true لإعادة فحص كاميرات USB المتصلة وتحديث قائمة الأجهزة المتاحة.

`Set Exposure` قيمة رقمية اختيارية لتعيين التعريض اليدوي على الكاميرا عند دعمها.

`Set Auto Exposure` قيمة رقمية اختيارية لتعيين وضع التعريض التلقائي عند دعم الجهاز لذلك.

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

`Camera Frame` أحدث إطار صورة تم التقاطه من الكاميرا USB المحددة.

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

`Source / Resolution Info` تسمية حالة تعرض مصدر الكاميرا الحالي والدقة النشطة.

ملاحظة: العديد من عناصر التحكم متاحة كمآخذ إدخال بحيث يمكن تحريك هذه الكتلة بواسطة كتل أخرى أو عناصر واجهة المستخدم.

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

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

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* عندما يكون `Activate Signal` true تحاول الكتلة تقديم الإطارات عبر `Camera Frame`.
* عندما يكون `Release Signal` true تتوقف الكتلة عن الالتقاط وتفرج عن موارد الكاميرا.
* تغيير `Camera Index` يؤدي إلى محاولة الكتلة لفتح الجهاز المُختار.
* تقديم `Resolution Width` و `Resolution Height` أثناء التشغيل سيحاول تغيير دقة الالتقاط.
* تقديم `Set Exposure` أو `Set Auto Exposure` سيحاول ضبط إعدادات التعريض إذا كان الجهاز يدعم ذلك.
* إذا واجهت الكتلة إطارات فارغة أو فاشلة متكررة فسوف تنفذ دورة إعادة تشغيل لاستعادة الكاميرا تلقائيًا.
* إذا تم تفعيل `Scan Cameras` تقوم الكتلة بتحديث قائمة الكاميرات المتاحة (مفيد عند توصيل أجهزة جديدة).

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

1. استخدم `Scan Cameras` أو اكتشاف الكاميرات في نظامك لسرد الأجهزة المتاحة.
2. قدم فهرس الجهاز المرغوب إلى `Camera Index` لاختيار الكاميرا.
3. اختياريًا اضبط `Resolution Width` و`Resolution Height` لحجم الالتقاط المطلوب.
4. أرسل `Activate Signal` لبدء التقاط الإطارات. راقب `Source / Resolution Info` لحالة التشغيل الحالية.
5. عدّل `Set Exposure` أو `Set Auto Exposure` فقط إذا كانت الكاميرا تدعم هذه الضوابط.
6. أرسل `Release Signal` عند الانتهاء لتحرير الجهاز.

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

* لمعاينة الإطارات مباشرة، وصل خرج `Camera Frame` إلى كتلة `Show Image` لعرض تفاعلي.
* لحفظ الإطارات أو إنشاء مجموعة بيانات، وصل `Camera Frame` إلى `Image Logger` أو `Record Video`.
* إذا كانت الإطارات تحتوي على ضجيج، جرّب تمريرها عبر `Blur` أو `Denoising` قبل إرسالها إلى الكواشف.
* قلل حجم المعالجة عن طريق تغيير حجم الالتقاطات عالية الدقة قبل العمليات الثقيلة: وصل `Camera Frame` إلى `Image Resize` ثم إلى كتل التحليل التالية.
* للتحليل المستند إلى منطقة، قم بقص الإطار باستخدام `Image ROI Select` قبل تشغيل كواشف مثل `Find Object` أو `Object Detection`.
* اجمعها مع كتل الذكاء الاصطناعي مثل `Object Detection - Custom` أو `Skeleton Estimation` لأنابيب استدلال مباشرة.
* استخدم `Scan Cameras` عند توصيل الكاميرات أثناء التشغيل حتى تكتشف الكتلة الأجهزة الجديدة دون إعادة تشغيل النظام بأكمله.

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

* لا توجد إطارات أو إطارات سوداء/فارغة:
  * تحقق من إدخال العدد الصحيح في `Camera Index`. إذا لم تكن متأكدًا، شغّل الفحص باستخدام `Scan Cameras`.
  * تأكد من أن تطبيقًا آخر لا يستخدم الكاميرا. أوقف أو أغلق التطبيقات الأخرى وحاول مجددًا.
  * جرّب قيم دقة أقل عبر `Resolution Width` و`Resolution Height` — بعض الكاميرات لا تستطيع البث باستقرار عند دقات عالية.
* عناصر تحكم التعريض بلا تأثير:
  * ليست كل الكاميرات أو المنصات تدعم التحكم البرنامجي في التعريض. إذا لم تُطبَّق الإعدادات، جرّب استخدام أداة البائع أو تحقق من تسمية المعلومات للكتلة لمعرفة القيم الحالية.
* فقدان الإطارات المتقطع أو حالات فشل:
  * جرّب استخدام منفذ USB مختلف أو موزع USB مزود بالطاقة. استخدم دقة أدنى لتقليل عرض النطاق.
  * إذا لم تساعد الاستعادة التلقائية، قم بتشغيل `Release Signal` ثم `Activate Signal` لإجبار إعادة تشغيل كاملة.
* الكاميرا غير مكتشفة عند الفحص:
  * تأكد أن الجهاز موصل ويعمل. أعد توصيل الكاميرا ثم فعِّل `Scan Cameras` مرة أخرى.
  * في بعض الأنظمة قد تتغير مؤشرات الأجهزة بعد إعادة التشغيل أو إعادة التوصيل — استخدم قائمة الفحص لاختيار الجهاز بشكل موثوق.

إذا استمرت المشكلات، اعرض الإطارات باستخدام `Show Image` وسجّل تسجيلًا قصيرًا عبر `Record Video` لفحص السلوك ومشاركته مع الدعم.