> 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/keyboard-barcode-reader.md).

# Keyboard/Barcode Reader

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

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

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

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

`Text` أحدث سطر نصي مُقروء من لوحة المفاتيح أو جهاز الباركود.

`Check` إشارة منطقية تشير إلى توفر قيمة نصية جديدة (مفيدة كمُحفز أو مشغّل).

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

`Mode` قائمة منسدلة لاختيار سلوك الإدخال. الخيارات الشائعة هي "Key Press" و "Barcode Reading".

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

* الاستماع في الخلفية لمدخلات على شكل لوحة مفاتيح بحيث يوفر البلوك أحدث نص مكتوب أو ممسوح دون تفاعل إضافي من المستخدم.
* يوفر كل من المحتوى النصي (`Text`) وإشارة منطقية على شكل مُحفّز (`Check`) لمساعدتك على التفاعل فقط عند وصول بيانات جديدة.
* تبديل وضع بسيط لمعاملة الأحداث الواردة كضغطة مفتاح عادية أو كمدخلات باركود (مفيد لأجهزة الماسح التي ترسل الكود الكامل دفعة واحدة).

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

1. اضبط السلوك المطلوب باستخدام `Mode`.
2. قم بربط مخرجات هذا البلوك إلى البلوكات اللاحقة التي تعالج أو تخزن النص.
3. استخدم المخرج `Check` لتشغيل إجراءات (مثلاً: تسجيل أو حفظ النص المقروء فقط عند وصول بيانات جديدة).

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

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

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

* للحفاظ على الإدخالات الممسوحة في ملف، اربط `Text` (أو استخدم `Check` كمُحفّز) إلى `CSV Export` أو `Data Write Local`.
* استخدم `Debug Input` لفحص القيم أثناء التطوير عندما تريد تسجيلًا سريعًا لما يتم قراءته.
* إذا أردت الجمع بين قراءة الباركود القائمة على الصورة وأجهزة الماسح الماديّة، استخدم هذا البلوك مع `Barcode Reader`: يمكن أن تعمل قراءة الكاميرا كخيار احتياطي أو تحقق متقاطع.
* للاختبار اليدوي أو حقن القيم بدون أجهزة، اقترن بـ `String Input` لتغذية قيم معروفة في التدفق.
* لبدء تدفقات العمل فقط عند قراءة رمز، قم بإدخال `Check` إلى بلوكات منطقية مثل `Logic Input` أو استخدمه لتشغيل `Image Logger` أو `Image Write` لربط صور بمعرّفات الممسوحة.

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

* لا يظهر نص: تأكد من تكوين قارئ الباركود كـ keyboard wedge (العديد من الماسحات تُرسل ضغطات مفاتيح).
* الماسح يرسل أحرفًا غير متوقعة: افحص إعدادات البادئات/اللاحقات في الماسح (مثل carriage return أو newline).
* قراءات مكررة أو مفقودة: جرّب تبديل `Mode` بين "Key Press" و "Barcode Reading" لمطابقة طريقة إرسال جهازك، واستخدم مخرج `Check` لتصفية التكرارات.
* مشاكل في الأذونات أو الوصول إلى الجهاز: تحقق من أن نظام التشغيل يتعرف على لوحة المفاتيح/الماسح وأنه لا يوجد تطبيق آخر يلتقط الإدخال حصريًا.