شارك المقالة
مسح المستندات في Flutter باستخدام flutter_document_scanner

مسح المستندات في Flutter باستخدام flutter_document_scanner

مسح المستندات في Flutter مع التقاط الصورة وقص المنظور والفلاتر، وفهم حدود flutter_document_scanner والفرق بين صورة المستند ونتيجة OCR.

مسح المستندات في Flutter مع التقاط الصورة وقص المنظور والفلاتر، وفهم حدود flutter_document_scanner والفرق بين صورة المستند ونتيجة OCR.

ما الذي يقدمه ماسح المستندات؟

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

اختيار الحزمة والتحقق من إعدادها

flutter_document_scanner حزمة لمنصتي Android وiOS بحسب صفحة المشروع، وتعرض التقاط الصور والقص والفلاتر. توضح وثائقها أنها ما زالت قيد التطوير وأن بعض الحالات والاختبارات ليست مكتملة، لذلك راجع متطلبات إصدارها مع مشروع صغير قبل اعتمادها. المثال القديم استورد BasicPage وCustomPage من تطبيق example غير موجود عند تثبيت الحزمة؛ المقطع التالي يستخدم الواجهة المصدرة من الحزمة نفسها ويترك ملكية controller للصفحة المستضيفة.

أذونات الكاميرا ودورة الحياة

أضف أوصاف الإذن وإعدادات المنصة التي تطلبها الحزمة ونسخة camera التابعة لها، ولا تطلب صلاحية المعرض إن لم تكن الميزة تستخدمه. رفض الإذن حالة متوقعة تحتاج شرحًا وإمكانية متابعة بديلة، وليس مؤشر تحميل لا ينتهي. عند مغادرة الصفحة أوقف الموارد والاشتراكات التي تملكها وفق API الإصدار. لا تفتح جلسة تصوير ثانية فوق الأولى عند نقر المستخدم سريعًا، ولا تبدأ تهيئة الكاميرا من build الذي قد يعاد لأسباب كثيرة.

الحفظ له معنى محدد

onSave يعيد بايتات صورة حسب عقد الحزمة؛ لا تطبع البايتات أو محتوى مستند خاص في console. اعرض معاينة واسمًا أو حجمًا ثم احفظ في مكان تختاره واجهة المنصة أو مخزن التطبيق. مجلد التطبيق ليس معرض الصور، وتصدير PDF ليس مجرد تغيير امتداد الملف. انتظر اكتمال الكتابة وأبلغ المستخدم بفشلها، واحذف الملفات المؤقتة التي لم يعتمدها وفق سياسة واضحة. إذا أضيفت مزامنة فافصل الحفظ المحلي عن نجاح الرفع.

جودة المسح قبل الفلاتر

استخدم ضوءًا مناسبًا وخلفية تختلف عن لون الورقة، واجعل الأطراف الأربعة ظاهرة بلا وهج. القص الخاطئ قد يحذف سطرًا لا يعيده أي فلتر، ولذلك وفر تعديلًا يدويًا للزوايا. قارن اللون الأصلي بالتدرج الرمادي عند وجود ختم أو نص ملون، ولا تجعل تباينًا عاليًا يمحو الخطوط الخفيفة. خفض دقة الصورة بشدة قد يقلل حجم الملف لكنه يضعف القراءة اللاحقة؛ قِس وضوح الخط وحجم الناتج مع عينات واقعية بدل وصف كل فلتر بأنه تحسين مضمون.

خطوات تجربة قابلة للتكرار

ابدأ بصورة ورقة تجريبية لا تحمل بيانات حقيقية، ثم اختبر الإلغاء ورفض الإذن والورقة المائلة والخلفية الداكنة. أعد فتح الصفحة بعد حفظ صورة وبعد فشل العملية، وجرب الرجوع أثناء التهيئة حتى لا يصل callback إلى State أُغلقت. اختبر الموارد الأصلية على جهاز فعلي لأن widget test لا يشغّل كاميرا أو OpenCV أو VisionKit. المقطع يوضح ربط واجهة المسح وحالة الحفظ فقط؛ راجع المثال الكامل للحزمة لإدارة مراحل التصوير والقص الملائمة لإصدارك.

فصل مكون المسح عن بقية التطبيق

اجعل صفحة المسح مسؤولة عن فتح التجربة وإغلاقها، وخدمة الملفات مسؤولة عن الحفظ، وصفحة المعاينة مسؤولة عن تأكيد المستخدم. بهذه الحدود يمكن استعمال الصورة الناتجة في OCR أو مرفق أو تصدير دون نسخ كود الكاميرا. لا تضع نافذة حفظ وتسجيل طلب شبكة داخل onSave بلا منع تكرار، فقد يستدعي تدفق المستخدم الحفظ مرة أخرى. أعد نتيجة واضحة إلى الصفحة التي فتحت الماسح ثم احتفظ بمعرف الملف الذي تأكد نجاحه فقط. اختبر الرجوع دون حفظ حتى لا يبقى مرفق وهمي في النموذج، ثم فشل كتابة القرص وإعادة المحاولة مع الصورة نفسها. إذا كان المستند كبيرًا فافحص حجم البايتات والذاكرة قبل عمل نسخ عديدة منه. نسخة Uint8List في المثال تعزل callback عن تعديل buffer الذي يستقبله، لكنها ليست تشفيرًا أو مسحًا آمنًا للمحتوى ولا بديلًا عن إدارة عمر الملف.

مثال الشفرة وحدوده

import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:flutter_document_scanner/flutter_document_scanner.dart';
// Integration widget, not a complete application.
// The route owner creates the controller and manages its lifecycle.
class ScanSurface extends StatelessWidget {
 const ScanSurface({super.key,required this.controller,required this.onSaved});
 final DocumentScannerController controller;
 final ValueChanged<Uint8List> onSaved;
 @override
 Widget build(BuildContext context)=>DocumentScanner(
  controller:controller,
  onSave:(Uint8List bytes){
    if(bytes.isEmpty) return;
    onSaved(Uint8List.fromList(bytes));
  },
 );
}
// Dependency: flutter_document_scanner, e.g. 1.1.2 after compatibility checks.
// Add native camera configuration from the package documentation.
// Persist/export bytes separately and handle write failures there.

مراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع