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

# HikVision Camera

هذا بلوك دالَة يربط كاميرات HikVision على شبكتك ويوفر إطارات صور حية للاستخدام في المعالجة اللاحقة والعرض.

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

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

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

`Image` الإطار الحي المسترجَع من كاميرا HikVision المُكوّنة.

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

`IP Address` أدخل عنوان IP الخاص بالكاميرا (أو اسم المضيف) لجهاز HikVision الذي تريد الاتصال به.

ملاحظة: سيحاول البلوك الاتصال بالعنوان المُدخل وسيوفر الإطارات تلقائيًا أثناء التشغيل.

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

* اتصال مباشر بكاميرات HikVision للحصول على إطارات حية.
* سلوك إعادة اتصال تلقائي عند تغيير عنوان الكاميرا أو فقدان الاتصال.
* دعم أساسي لمعلمات الكاميرا عندما توفر الكاميرا/SDK إعدادات (مثل exposure وإعدادات ذات صلة متاحة عبر إعدادات الكاميرا).
* رسائل خطأ واضحة لتسهيل تشخيص مشكلات الاتصال.

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

1. أدخل عنوان الشبكة الخاص بالكاميرا في عنصر التحكم `IP Address`.
2. شغّل السيناريو؛ سيتصل البلوك بالكاميرا ويبدأ في إخراج الإطارات عبر مخرج `Image`.
3. استخدم الإطارات الناتجة مع بلوكات العرض، التسجيل، أو التحليل (أمثلة في الأسفل).

## 📊 سلوك التشغيل <a href="#evaluation" id="evaluation"></a>

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

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

* استخدم `Show Image` لمعاينة الإطارات في واجهة المستخدم أثناء بناء السيناريو.
* احفظ الإطارات المهمة باستخدام `Image Logger` أو `Record Video` للمراجعة لاحقًا.
* إذا كانت تحليلاتك مكثفة، أضف `Image Resize` قبل بلوكات النماذج لتقليل حمل المعالجة.
* قص مناطق الاهتمام باستخدام `Image ROI` أو `Image ROI Select` لتركّز التحليل على المناطق المهمة.
* لعمليات العد أو التتبع، اقترن مع `Object Detection` أو `Object Detection - Custom` ثم `Object_Detection_Tracker`.
* استخدم `Mask Detection` أو `Background Subtractor` عندما تحتاج لتصفية الأشخاص أو الكائنات الأمامية قبل التحليل الإضافي.
* دمجه مع `Image Write` أو `Multi Image Write` لتصدير إطارات محددة عند حدوث أحداث تشغيلية.

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

* فشل الاتصال: تأكد من أن عنوان IP الخاص بالكاميرا قابل للوصول من الجهاز الذي يشغّل Studio (جرّب ping على الكاميرا، وتحقق من إعدادات الشبكة/VLAN).
* لا توجد إطارات أو إطارات سوداء: تحقق من طاقة الكاميرا، إعدادات التعريض/البث على الكاميرا، وتأكد من عدم احتكار تطبيق آخر للكاميرا.
* متطلبات SDK/برنامج تشغيل: بعض موديلات HikVision قد تتطلب تثبيت SDK أو برامج تشغيل من البائع—تأكد من وجود حزم الدعم المطلوبة على النظام.
* مشكلات المصادقة أو جدران الحماية: تحقق من أن بيانات اعتماد الكاميرا وقواعد الشبكة تسمح بالوصول من جهاز الكمبيوتر أو الخادم الخاص بك.

إذا استمرت المشاكل، عاين العنوان باستخدام `Show Image` أو أعد التحقق من إعدادات الشبكة والكاميرا قبل المتابعة.