Skaner dokumentów z ML Kit na Androidzie

Użyj interfejsu Document Scanner API ML Kit, aby łatwo dodać funkcję skanera dokumentów do do aplikacji.

Wypróbuj

Wypróbuj przykładowa aplikacja aby zobaczyć przykład użycia tego interfejsu API.

Zanim zaczniesz

1. W pliku build.gradle na poziomie projektu umieść tag Google Repozytorium Maven w sekcjach buildscript i allprojects.

2. Dodaj zależność z biblioteką skanera dokumentów ML Kit do jest to plik Gradle modułu na poziomie aplikacji, który jest zwykle app/build.gradle:

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

Konfiguracja skanera dokumentów

sposób korzystania ze skanera dokumentów (obejmuje to specjalny ekran wizjera); i ekran podglądu) jest dostępny w pakiecie SDK. Wizjer i ekran podglądu obsługują te elementy sterujące, które można dostosować:

• importuję z galerii zdjęć
• ustawianie limitu liczby skanowanych stron;
• tryb skanera (do sterowania zestawami funkcji podczas procesu)

Zeskanowane dokumenty możesz pobrać zarówno w formacie PDF, jak i JPEG.

Utwórz instancję GmsDocumentScannerOptions, aby skonfigurować opcje skanera:

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