> 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/data-inputs/headless-check.md).

# Headless Check

هذا البلوك يبلغك عما إذا كانت الجلسة الحالية تعمل في وضع headless (بدون واجهة مستخدم). استخدمه لتكييف سلوك السيناريو عند التشغيل على خوادم أو في بيئات مؤتمتة.

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

هذا البلوك لا يحتوي على أي مدخلات.

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

`Check` هذه المخرجات تعيد قيمة منطقية: TRUE عندما يكون السيناريو يعمل في وضع headless، و FALSE عندما تكون واجهة المستخدم متاحة.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

هذا البلوك لا يعرض أي عناصر تحكم للمستخدم.

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

* مؤشر بسيط TRUE/FALSE مناسب للتحكم بتدفق السيناريو.
* خفيف الوزن وآمن لوضعه في أي مكان في التدفق لتكييف السلوك في الخطوات التالية.
* مناسب كإشارة تحكم لربط بلوكات المعتمدة على الواجهة مثل عرض النوافذ أو لتبديل سلوك التسجيل والتصدير في التشغيل المؤتمت.

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

1. ضع البلوك في الموضع الذي تحتاج فيه لاتخاذ قرار بين سلوك بواجهة مستخدم أو بدونها.
2. اوصل ناتج `Check` إلى بلوكات منطق أو تحكم لتمكين/تعطيل فروع السيناريو (مثلاً لتخطي المخرجات المرئية عندما تكون في وضع headless).
3. استخدم النتيجة مع بلوكات منطق مثل `And` / `Or` / `Not` أو مع بلوكات التحكم بالتدفق لتطبيق سلوك شرطي.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التنفيذ، يعيد هذا البلوك قيمة منطقية واحدة على `Check` تشير لوجود أو غياب واجهة المستخدم للجلسة الحالية.

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

* لتجنب فتح نوافذ على الخوادم، استخدم `Check` كـ gate لبلوك `Show Image` بحيث يتم تمكين عارض الصور فقط عندما لا تكون في وضع headless.
* في التشغيلات headless قد تفضل حفظ النتائج بدلاً من عرضها. اجمع `Check` مع بلوكات التصدير مثل Image Logger, Image Write, Record Video، أو CSV Export لحفظ المخرجات تلقائياً عند عدم وجود واجهة.
* استخدم `Check` مع بلوكات منطق مثل `Not`, `And` أو `Or` لبناء قواعد مرنة (مثال: حفظ الصور فقط عندما يكون headless AND مشغل بواسطة `Logic Input`).
* عند تشغيل تقييمات مؤتمتة، اوصل `Check` إلى `Stop` لإنهاء السيناريوهات المعتمدة على الواجهة بشكل منسق فقط عندما تكون واجهة المستخدم موجودة.

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

* إذا بدا أن البيئة تعمل في وضع headless لكن `Check` يعيد FALSE، تحقق من طريقة بدء السيناريو (بعض جلسات سطح المكتب البعيد أو الشاشات الافتراضية قد تظهر كـ GUI).
* إذا كنت بحاجة لسلوك مختلف في إعدادات نصف-headless (مثلاً عمليات GPU في الخلفية مع واجهة عرض عرضية)، اجمع `Check` مع `Logic Input` يدوي لتفصيل التحكم.