استخراج النص من صورة المعرض في Flutter مع google_mlkit_text_recognition، وحفظ الأسطر ومعالجة النتيجة الفارغة وإغلاق recognizer بأمان.
نطاق هذا الدرس وصورة المستخدم
يعالج هذا المسار صورة يختارها المستخدم من المعرض، فلا يعيد شرح تشغيل كاميرا مستمرة أو يخلط صور المستندات بتوليد النصوص. اختيار صورة قد ينتهي بإلغاء، وقد تتوفر الصور المختارة فقط دون وصول كامل للألبوم حسب المنصة. استخدم image_picker ومتطلبات الإصدار الملائمة بدل قراءة مسار DCIM يدويًا. لا تنقل صورة إلى خدمة خارجية إذا كان التصميم يستعمل التعرف المحلي؛ أي رفع إضافي يحتاج غرضًا واضحًا مستقلًا عن اختيار الملف.
ربط الحزمة المناسبة
استعمل حزمة google_mlkit_text_recognition المتخصصة بدل الاعتماد على imports قديمة أو حزمة شاملة لميزات لا تحتاجها. أضف image_picker ثم راجع متطلبات Android وiOS وقواعد الصور والأذونات كما توثقها النسخ المختارة. إتاحة API في Dart لا تثبت دعم الويب أو سطح المكتب في هذا plugin، ولا يعني أن المكتبة تدرب نموذجك تلقائيًا. المعالجة الأصلية تأتي عبر ML Kit، وواجهة Flutter تعرض النتيجة وتدير الحالة.
Scripts وحدود العربية
TextRecognitionScript.latin في المثال مخصص للكتابة اللاتينية؛ تغيير اسم المتغير أو لغة MaterialApp إلى العربية لا يضيف OCR عربيًا. توجد scripts أخرى مدعومة ومذكورة في الوثائق، ويجب تقييم المحرك الذي يدعم الكتابة التي تحتاجها قبل اختيار المنتج. إذا كانت الصورة متعددة اللغات فلا تتوقع أن اختيار Latin يقرأ كل سطر. اختبر نصوصًا واضحة ومائلة وأرقامًا، وقيّم الفشل بدل إخفائه بنتيجة افتراضية تبدو صحيحة.
الأسطر والكتل وإعادة الاستخدام
النتيجة توفر text وكذلك blocks وlines وعناصر أكثر تفصيلًا. استعمل result.text إذا كنت تحتاج نصًا عامًا، أو اجمع lines بفاصل السطر الحقيقي إذا احتجت معالجة حسب السطر. الحرف n أو النص nn في المثال السابق لا يصنع سطرًا جديدًا. ترتيب OCR ليس محلل أعمدة أو جداول كاملًا؛ قد تحتاج قراءة مواضع الكتل لفاتورة ذات عمودين. اجعل قاعدة استخراج حقل معين دالة مستقلة قابلة للاختبار ولا تخلطها بضغط زر المعرض.
حالة العملية والفشل
احرس الطلب من التداخل وأعد تمكين الزر في finally، سواء أخفق picker أو recognizer. أنشئ recognizer للطلب ثم أغلقه بعد اكتمال العمل، ولا تغلق المورد بينما لا تزال عملية تستخدمه. إذا استعملت instance مشتركة فمالكها يحدد إغلاقها بعد توقف العمليات. بعد await افحص عمر الصفحة قبل setState، ولا تعرض نص صورة قديمة إذا تغير الاختيار أثناء معالجة سابقة. النتيجة الفارغة حالة عادية لصورة لا تحوي كتابة مدعومة.
التجربة والتأكيد قبل الحفظ
اعرض النص بطريقة تسمح بنسخه أو تصحيحه، واطلب مراجعة القيم المهمة في نموذج بدل إرسالها تلقائيًا. اختبر الإلغاء وصورة تالفة وصورة بلا نص وفشل الخدمة وإغلاق الصفحة. دالة joinOcrLines أدناه تختبر المحافظة على حدود الأسطر دون الاعتماد على ML Kit؛ وهي ليست محرك OCR بحد ذاتها. جودة التعرف تحتاج صورة اختبار مرخصة وجهازًا مستهدفًا، فلا تجعل نجاح widget test دليلًا على دقة الأرقام أو الأسماء في مستند حقيقي.
التحويل إلى حقول يأتي بعد النص
إذا كان الهدف رقم فاتورة أو تاريخًا فحدد موضع الحقل أو اسمه ونطاقه المتوقع ثم اعرضه للمراجعة، ولا تقطع أول أرقام في النص وتفترض أنها القيمة المقصودة. يمكن أن تحتوي الصورة أرقام هاتف وأسعارًا وتواريخ متجاورة. حافظ على النص الأصلي للمراجعة ضمن سياسة حفظ مناسبة وأبق التفسير المشتق منفصلًا كي يمكن تصحيح قاعدة الاستخراج دون إعادة OCR بلا داع. لا تضف n في نهاية كل سطر كحل بديل للفاصل الحقيقي، واختبر أن دالة التجميع تعيد عدد الأسطر نفسه بما فيها سطر فارغ إن سمح العقد به. إذا تحتاج layout محفوظًا فـString واحدة لا تكفي؛ احتفظ بإحداثيات الكتل أو نموذج مستند يناسب الاستخدام. النص القابل للنسخ ليس نسخة مطابقة لكل مسافات وأعمدة الصورة الأصلية.
مثال الشفرة وحدوده
import 'package:image_picker/image_picker.dart';
import 'package:google_mlkit_text_recognition/google_mlkit_text_recognition.dart';
String joinOcrLines(Iterable<String> lines)=>lines.join('\n');
Future<String?> readGalleryText({Future<XFile?> Function()? pick, Future<String> Function(String)? read}) async {
final picked=await (pick==null?ImagePicker().pickImage(source:ImageSource.gallery):pick());
if(picked==null)return null;
if(read!=null)return read(picked.path);
final recognizer=TextRecognizer(script:TextRecognitionScript.latin);
try {
final recognized=await recognizer.processImage(InputImage.fromFilePath(picked.path));
return joinOcrLines([
for(final block in recognized.blocks)
for(final line in block.lines) line.text,
]);
} finally {await recognizer.close();}
}
// Install the two imports' packages and their Android/iOS native setup.
// null means cancellation; '' means no recognized lines.
// No Arabic OCR support is implied by this Latin example.الصور والفيديو من الشرح
قد تعرض المواد إصدارًا أقدم من المكتبات؛ اعتمد النص المصحح عند اختلاف الإعدادات أو الكود.







