الماسح الضوئي للمستندات باستخدام حزمة ML Kit على Android

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

جرّبه الآن

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

قبل البدء

1. في ملف build.gradle على مستوى المشروع، تأكد من تضمين Maven في قسمَي "النص البرمجي" و"جميع المشاريع".

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

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

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

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

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

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

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

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();

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(...);