الماسح الضوئي للمستندات مع حزمة تعلّم الآلة على Android

استخدِم واجهة برمجة التطبيقات "الماسح الضوئي للمستندات" في حزمة تعلّم الآلة لإضافة ميزة "الماسح الضوئي للمستندات" بسهولة إلى تطبيقك.

الميزة التفاصيل
اسم حزمة تطوير البرامج (SDK) play-services-mlkit-document-scanner
التنفيذ يتم تنزيل النماذج ومنطق المسح الضوئي وتدفق واجهة المستخدم ديناميكيًا من خلال "خدمات Google Play".
تأثير حجم التطبيق زيادة حجم التنزيل بمقدار 300 كيلوبايت تقريبًا
وقت التهيئة قد يضطر المستخدمون إلى الانتظار إلى حين تنزيل النماذج والمنطق وتدفق واجهة المستخدم قبل الاستخدام الأول.

للتجربة:

يمكنك تجربة التطبيق النموذجي للاطّلاع على مثال على استخدام واجهة برمجة التطبيقات هذه.

قبل البدء

  1. في ملف build.gradle على مستوى المشروع، تأكَّد من تضمين مستودع Maven من Google في كلٍّ من قسمَي buildscript وallprojects.

  2. أضِف الاعتمادية لمكتبة الماسح الضوئي للمستندات في حزمة تعلّم الآلة إلى ملف Gradle على مستوى التطبيق في الوحدة، والذي يكون عادةً app/build.gradle:

dependencies {
   // …
   implementation 'com.google.android.gms:play-services-mlkit-document-scanner:16.0.0'
}

إعداد "الماسح الضوئي للمستندات"

توفّر حزمة تطوير البرامج (SDK) مسار مستخدم "الماسح الضوئي للمستندات" (الذي يتضمّن شاشة محدّدة لمنظار الكاميرا وشاشة معاينة). تتيح شاشة منظار الكاميرا وشاشة المعاينة عناصر التحكّم القابلة للتخصيص التالية:

  • استيراد الصور من معرض الصور
  • وضع حدّ لعدد الصفحات التي يتم مسحها ضوئيًا
  • وضع الماسح الضوئي (للتحكّم في مجموعات الميزات في المسار)

يمكنك استرداد ملفات PDF وJPEG لمستنداتك التي تم مسحها ضوئيًا.

أنشِئ مثيلاً من GmsDocumentScannerOptions لضبط خيارات الماسح الضوئي:

Kotlin

val options = GmsDocumentScannerOptions.Builder()
    .setGalleryImportAllowed(false)
    .setPageLimit(2)
    .setResultFormats(RESULT_FORMAT_JPEG, RESULT_FORMAT_PDF)
    .setScannerMode(SCANNER_MODE_FULL)
    .build()

جافا

GmsDocumentScannerOptions options = new GmsDocumentScannerOptions.Builder()
    .setGalleryImportAllowed(false)
    .setPageLimit(2)
    .setResultFormats(RESULT_FORMAT_JPEG, RESULT_FORMAT_PDF)
    .setScannerMode(SCANNER_MODE_FULL)
    .build();

مسح المستندات ضوئيًا

بعد إنشاء GmsDocumentScannerOptions، احصل على مثيل من GmsDocumentScanner. يمكنك بعد ذلك بدء نشاط الماسح الضوئي باتّباع واجهات برمجة التطبيقات Activity Result APIs التي تم طرحها في AndroidX.

عند اكتمال عملية المسح الضوئي للمستند، سيمنح كائن GmsDocumentScanningResult إمكانية الوصول إلى عدد الصفحات التي تم مسحها ضوئيًا ومعرّفات URI للصور بتنسيق JPEG وPDF وفقًا لما تم تحديده من خلال setResultFormats:

Kotlin

val scanner = GmsDocumentScanning.getClient(options)
val scannerLauncher = registerForActivityResult(StartIntentSenderForResult()) {
  result -> {
    if (result.resultCode == RESULT_OK) {
      val result =
        GmsDocumentScanningResult.fromActivityResultIntent(result.data)
      result.getPages()?.let { pages ->
        for (page in pages) {
          val imageUri = pages.get(0).getImageUri()
        }
      }
      result.getPdf()?.let { pdf ->
        val pdfUri = pdf.getUri()
        val pageCount = pdf.getPageCount()
      }
    }
  }
}

scanner.getStartScanIntent(activity)
  .addOnSuccessListener { intentSender ->
     scannerLauncher.launch(IntentSenderRequest.Builder(intentSender).build())
   }
  .addOnFailureListener {
    ...
  }

جافا

GmsDocumentScanner scanner = GmsDocumentScanning.getClient(options);
ActivityResultLauncher<IntentSenderRequest> scannerLauncher =
  registerForActivityResult(
    new StartIntentSenderForResult(),
      result -> {
        if (result.getResultCode() == RESULT_OK) {
          GmsDocumentScanningResult result = GmsDocumentScanningResult.fromActivityResultIntent(result.getData());
          for (Page page : result.getPages()) {
            Uri imageUri = pages.get(0).getImageUri();
          }

          Pdf pdf = result.getPdf();
          Uri pdfUri = pdf.getUri();
          int pageCount = pdf.getPageCount();
        }
      });

scanner.getStartScanIntent(activity)
  .addOnSuccessListener(intentSender ->
    scannerLauncher.launch(new IntentSenderRequest.Builder(intentSender).build()))
  .addOnFailureListener(...);

نصائح لتحسين الأداء

ضَع في اعتبارك أنّ إنشاء ملفات المستندات يستغرق وقتًا ويتطلّب قوة معالجة، لذا اطلب تنسيقات الإخراج (JPEG أو PDF أو كليهما) التي تحتاج إليها فقط.