استخدام flutter_barcode_listener في Flutter لاستقبال بيانات قارئ عتادي يحاكي لوحة المفاتيح، مع منع التكرار وفصل ذلك عن مسح الكاميرا وOCR.
تصحيح نوع الماسح
flutter_barcode_listener تستمع لتتابع إدخال قارئ عتادي يعمل بأسلوب لوحة المفاتيح، وليست نموذج رؤية حاسوبية ولا كاميرا تكتشف البطاقة. قد يتصل القارئ عبر USB أو Bluetooth وفق الجهاز، ثم يرسل أحرفًا وفاصل نهاية. قراءة RFID لها أيضًا أنواع وأوضاع مختلفة؛ رابط مشروع يحمل اسم rfid لا يجعل كل قارئ مدعومًا تلقائيًا. اختر نوع التدفق أولًا: صورة باركود، نص من قارئ، أم بروتوكول SDK خاص بالمصنع.
الكاميرا مسار آخر
إن كنت تريد توجيه كاميرا الهاتف إلى QR أو باركود فاختر حزمة كاميرا لمسح الرموز لها إعدادات أصلية وأذونات مناسبة. هذا يختلف أيضًا عن OCR الذي يستخرج الحروف المطبوعة بجوار الرمز. لا تستخدم النص المقروء كملف JSON أو URL موثوق دون التحقق منه؛ الرمز مجرد حاوية بيانات قد تحتوي قيمة غير متوقعة. عند مسح بطاقة عرض البيانات يحتاج خدمة صلاحيات أو قاعدة موثوقة، لا افتراض أن كل رقم عائد اسم شخص معروف.
إعداد القارئ والمهلة
تحقق من وضع keyboard wedge والفاصل الذي يرسله الجهاز وتخطيط لوحة المفاتيح والسرعة. bufferDuration تساعد تجميع التتابع بحسب تنفيذ الحزمة وليست معيارًا صالحًا لكل طراز. إن كان القارئ يرسل نصًا بطيئًا فقد يتجزأ، وإن كانت المهلة واسعة فقد يختلط إدخال يدوي مع المسح. اختبر جهازك الحقيقي وعينة رموز عامة، ولا تعد أن إعداد 200ms أدناه سيعمل على كل الأجهزة دون معايرة.
منع التكرار لا حذف العمليات الصحيحة
قد يرسل القارئ الرمز نفسه مرات متتالية. المثال يفحص نصًا غير فارغ وطولًا أقصى ثم يتجاهل تكرار القيمة نفسها ضمن نافذة قصيرة في الذاكرة. هذا debounce للواجهة، وليس مفتاح منع تكرار مالي في الخادم. إذا كان تكرار الرمز مقصودًا لزيادة كمية منتج فعدّل السياسة واجعلها واضحة للمستخدم. لا تحجب جميع القيم خلال مهلة واحدة؛ رمزان مختلفان سُحبا بسرعة قد يمثلان عمليتين صحيحتين.
نطاق المستمع والتركيز
استعمل المستمع داخل الشاشة التي تحتاج القارئ، واختبر ماذا يحدث عند فتح حوار أو حقل تحرير أو انتقال المستخدم إلى شاشة أخرى. لا تسجل كل ضغطات لوحة المفاتيح في سجل دائم لمجرد تشخيص الماسح. إن كان المنتج يحتاج حقل إدخال واحدًا فقط فقد يكفي TextField مركز بدل مستمع عالمي. استخدم رسالة حالة تعرض أن القارئ جاهز أو أن الرمز غير صالح، مع طريقة إعادة محاولة وتصحيح إدخال يدوي حين يلزم.
اختبار التكامل بصورة واقعية
ابدأ بباركود تجريبي ولا تربط أول تجربة ببيانات مستخدم أو حفظ نهائي. اختبر الإنهاء الصحيح والرمز الطويل والنص الفارغ والتكرار ورمزين مختلفين، ثم فصل الجهاز وإعادة وصله. المقطع التالي يختبر سياسة قبول القيم بصورة مستقلة ويمكن تمرير نتيجته من onBarcodeScanned. ربط الحزمة يحتاج Widget BarcodeKeyboardListener وفق API الإصدار ووضع الطفل الذي تريده داخله؛ لا يحتاج إذن كاميرا لأن هذا النوع من الإدخال لا يصور شيئًا.
تحديد اللحظة التي تقبل فيها العملية
ابدأ Stopwatch عند بدء جلسة المسح ومرر elapsed إلى سياسة التكرار، فالمثال يقارن فترات لا مواعيد تقويم تتغير مع ساعة الجهاز. إذا أعيد إنشاء الشاشة فحدد هل تبدأ نافذة جديدة أم يبقى آخر رمز من الجلسة السابقة وفق سياسة المنتج. اختبر رمزًا مكررًا داخل المدة وخارجها ورمزًا مختلفًا داخل المدة نفسها؛ ينبغي أن تختلف النتيجة بحسب العقد لا بحسب عدد callbacks. القيمة المقبولة قد تبقى غير موجودة في قاعدة المنتجات، لذلك افصل قبول الإدخال عن نجاح الاستعلام والحفظ. وإذا فتح المستخدم حقلًا يدويًا فلا تجعل الماسح يلصق بيانات في عنصر آخر بلا تنبيه. عدم الحاجة لكاميرا هنا يقلل جزءًا من التعقيد لكنه لا يحل إعدادات فاصل القارئ أو تخطيط لغة لوحة المفاتيح الذي يجب اختباره على طراز الجهاز المقصود.
مثال الشفرة وحدوده
class ScanDeduplicator {
String? _last;
Duration? _lastAt;
bool accept(String raw,Duration now){
final value=raw.trim();
if(value.isEmpty||value.length>512)return false;
if(_last==value&&_lastAt!=null&&now>=_lastAt!&&
now-_lastAt!<const Duration(milliseconds:800))return false;
_last=value;_lastAt=now;return true;
}
}
// Own one instance per scanning session; use Stopwatch.elapsed for now.
// Integration after adding flutter_barcode_listener:
// BarcodeKeyboardListener(
// bufferDuration: const Duration(milliseconds:200),
// onBarcodeScanned:(value){
// if(gate.accept(value,clock.elapsed)){ /* validate and handle once */ }
// }, child: yourPage,
// );
// This is hardware keyboard input, not camera recognition.






