إضافة Flutter OCR بالكاميرا مع image_picker وML Kit، وفصل التقاط الصورة عن التعرف على النص ومعالجة الإلغاء والفشل وحدود اللغات.
تصوير نص لا بث كل الإطارات
هذا الدرس مخصص لالتقاط صورة واحدة بالكاميرا ثم استخراج نصها، بينما درس المعرض المرتبط يعالج صورة موجودة. لا تحتاج بث كاميرا مستمرًا إذا كان المستخدم سيضغط زر التقاط ويؤكد النتيجة. image_picker يتولى تجربة الالتقاط وفق المنصة، ثم ينتقل المسار المختار إلى recognizer. الناتج نص مقدر يحتاج مراجعة؛ وجوده لا يثبت صحة فاتورة أو هوية أو مبلغ، ولا ينبغي اعتماده تلقائيًا دون تحقق حقول المنتج.
اختيار المكتبات واللغة
يمكن استعمال google_mlkit_text_recognition مع image_picker، وإعداد متطلبات Android وiOS الخاصة بالنسخ المتوافقة. حزم Flutter التي تربط ML Kit يديرها مجتمعها وليست مكتبة Flutter رسمية من Google. نطاق scripts المعلن يشمل Latin وChinese وDevanagari وJapanese وKorean؛ لا يتضمن وعدًا بدعم الخط العربي. اختيار Locale عربية لواجهة التطبيق أو تبديل TextDirection لا يضيف نموذج OCR عربيًا. إذا كانت العربية شرطًا فاختر محركًا يدعمها واختبره بعيناتك.
الأذونات والإلغاء
أضف وصف استخدام الكاميرا وإعدادات picker بحسب المنصة، وميز بين رجوع المستخدم دون صورة ورفض الإذن وفشل الالتقاط. null من pickImage يعني إلغاءً طبيعيًا لا خطأ يحتاج تنبيهًا مخيفًا. عطل زر المعالجة أثناء انتظار العملية أو امنع الطلب المتداخل، واحتفظ بالنص السابق حتى ينجح اختيار جديد إذا كانت هذه سياسة المنتج. لا تمسح النتيجة لمجرد أن المستخدم فتح الكاميرا ثم أغلقها.
صورة مناسبة للتعرف
اجعل النص كبيرًا وواضحًا قدر الإمكان، وحافظ على الأركان المطلوبة من المستند دون قص الحروف أو انعكاس الضوء. افحص اتجاه الصورة ومعالجته قبل تحويلها إلى صيغة InputImage. جودة عالية جدًا قد تزيد الزمن والذاكرة بلا فائدة، بينما تصغيرها بشدة يمحو التفاصيل. قارن دقة الاستخراج والزمن مع صور تجريبية متنوعة، وجرب لقطة لا تحوي نصًا حتى تعرف كيف ستعرض نتيجة فارغة بدل تحميل دائم.
الخدمة وعمر الموارد
المقطع ينشئ recognizer لطلب واحد ويغلقه في finally سواء نجحت القراءة أو فشلت، ولا يطبع النص المصور في logs. عند وصله بواجهة State افحص mounted بعد await قبل عرض النتيجة، وميز النص الفارغ عن الاستثناء. لا تسند العملية إلى FutureBuilder بإنشاء Future جديدة في كل build. يمكن حقن خدمة القراءة أو منتقي الصورة في الاختبار حتى تفحص الإلغاء والفشل دون فتح كاميرا حقيقية أو مشاركة مستندات مستخدمين.
عرض النص وإكمال التدفق
اعرض النص في SelectableText أو محرر حسب الحاجة، وأتح للمستخدم تصحيح الأخطاء قبل الحفظ أو الإرسال. OCR لا يحدد تلقائيًا أي سطر اسم وأيهما عنوان؛ استخراج الحقول مرحلة تالية لها قواعد وفحوص مستقلة. اختبر كاميرا جهاز فعلي وإعادة فتح الصفحة والعودة أثناء العملية، ثم قارِن الناتج مع نص معروف. اختبارات Dart وحدها لا تثبت دقة ML Kit أو إعداد الكاميرا الأصلي، لذلك سجل المنصة وإصدار المحرك وعينة غير حساسة عند تقييم الأداء.
فصل الخدمة يوضح سبب المشكلة
يمكن لواجهة الصفحة أن تستدعي خدمة تعيد null للإلغاء، ونصًا فارغًا لعدم العثور على كتابة، ونصًا آخر للنجاح، أو استثناء للفشل. اختبر هذه الحالات الأربع على حدة بدل تحويلها جميعًا إلى رسالة لم ينجح المسح. عند إعادة محاولة اختر هل تريد صورة جديدة أم إعادة قراءة الصورة الموجودة؛ الخياران مختلفان في الزمن وتجربة المستخدم. إذا قرر المستخدم حذف النتيجة فلا ينبغي أن تعيد عملية قديمة متأخرة ملأها، ويمكن استعمال معرف عملية إلى جانب mounted عند السماح بطلبات قابلة للاستبدال. اختبار الخدمة بمنتقٍ ومحرك وهميين يثبت هذا العقد دون تصوير، أما معاينة النص اللاتيني الفعلي فتحتاج المحرك الأصلي. تجنب أسماء مثل readArabic عندما تكون النصوص المدعومة في المثال Latin، لأن اسم الدالة نفسه قد ينقل افتراضًا خاطئًا لمطور يستعملها لاحقًا في شاشة أخرى.
مثال الشفرة وحدوده
import 'package:image_picker/image_picker.dart';
import 'package:google_mlkit_text_recognition/google_mlkit_text_recognition.dart';
Future<String?> captureLatinText({Future<XFile?> Function()? pick, Future<String> Function(String)? read}) async {
final photo=await (pick==null?ImagePicker().pickImage(source:ImageSource.camera):pick());
if(photo==null)return null; // User cancellation.
if(read!=null)return read(photo.path);
final recognizer=TextRecognizer(script:TextRecognitionScript.latin);
try {
final result=await recognizer.processImage(InputImage.fromFilePath(photo.path));
return result.text; // Empty text is a valid result.
} finally {await recognizer.close();}
}
// Android/iOS integration service, not a standalone UI.
// Dependencies: image_picker and google_mlkit_text_recognition.
// Configure native requirements and permissions from both packages.
// Prevent concurrent calls in the UI; check mounted after awaiting.
// Latin recognition does not imply Arabic OCR support.






