在 Android 上使用 ML Kit 使用文件掃描器

使用 ML Kit 文件掃描器 API，輕鬆在應用程式中新增文件掃描器功能。

功能 詳細資料
SDK 名稱 play-services-mlkit-document-scanner
導入作業 Google Play 服務會以動態方式下載模型、掃描邏輯和 UI 流程。
應用程式大小影響 下載大小可增加約 300 KB。
初始化時間 使用者可能需要等待下載模型、邏輯和 UI 流程後才能開始使用。

立即體驗

試試這個範例應用程式，查看這個 API 的使用範例。

事前準備

  1. 在專案層級的 build.gradle 檔案中，請務必在 buildscript 和 allprojects 區段中加入 Google 的 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 執行個體化以設定掃描器選項：

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

掃描文件

建立 GmsDocumentScannerOptions 後，請取得 GmsDocumentScanner 的執行個體。接著，您可以依照 AndroidX 中導入的 Activity Result API 啟動掃描器活動。

文件掃描完成後，GmsDocumentScanningResult 物件會授予已掃描頁面數、JPEG 格式圖片 URI 和 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 {
    ...
  }

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

提高成效的訣竅

因此，產生文件檔案需要處理時間和處理能力，因此請只要求實際需要的輸出格式 (JPEG 或 PDF 或兩者)。