Pemindai dokumen dengan ML Kit di Android

Gunakan ML Kit document scanner API untuk menambahkan fitur pemindai dokumen ke aplikasi Anda dengan mudah.

Fitur Detail
Nama SDK play-services-mlkit-document-scanner
Penerapan Model, logika pemindaian, dan alur UI didownload secara dinamis oleh layanan Google Play.
Dampak ukuran aplikasi Peningkatan ukuran download ~300 KB.
Waktu inisialisasi Pengguna mungkin harus menunggu model, logika, dan alur UI didownload sebelum penggunaan pertama.

Cobalah

Coba aplikasi contoh untuk melihat contoh penggunaan API ini.

Sebelum memulai

  1. Pada file build.gradle level project, pastikan untuk menyertakan repositori Maven Google di bagian buildscript dan allprojects Anda.

  2. Tambahkan dependensi untuk library pemindai dokumen ML Kit ke file gradle level aplikasi modul Anda, biasanya app/build.gradle:

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

Konfigurasi Pemindai Dokumen

Alur pengguna pemindai dokumen (yang mencakup layar jendela bidik dan layar pratinjau khusus) disediakan oleh SDK. Layar jendela bidik dan pratinjau mendukung kontrol yang dapat disesuaikan berikut:

  • mengimpor dari galeri foto
  • menetapkan batas jumlah halaman yang dipindai
  • mode pemindai (untuk mengontrol kumpulan fitur dalam alur)

Anda dapat mengambil file PDF dan JPEG untuk dokumen yang dipindai.

Buat instance GmsDocumentScannerOptions untuk mengonfigurasi opsi pemindai:

Kotlin

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

Java

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

Pindai dokumen

Setelah membuat GmsDocumentScannerOptions, dapatkan instance GmsDocumentScanner. Kemudian, Anda dapat memulai aktivitas pemindai dengan mengikuti Activity Result API yang diperkenalkan di AndroidX.

Setelah pemindaian dokumen selesai, objek GmsDocumentScanningResult akan memberikan akses ke jumlah halaman yang dipindai, URI gambar dalam format JPEG, dan PDF sesuai dengan yang ditentukan melalui 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 {
    ...
  }

Java

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

Tips untuk meningkatkan performa

Perlu diingat bahwa pembuatan file dokumen memerlukan waktu dan daya pemrosesan, jadi hanya minta format output (JPEG, atau PDF, atau keduanya) yang benar-benar Anda butuhkan.