Android 上带有机器学习套件的文档扫描器
使用机器学习套件文档扫描器 API 可轻松为您的应用添加文档扫描器功能。
功能 | 详细信息 |
---|---|
SDK 名称 | play-services-mlkit-document-scanner |
实现 | Google Play 服务会动态下载模型、扫描逻辑和界面流程。 |
应用大小影响 | 下载大小增加约 300KB。 |
初始化时间 | 用户可能必须等到模型、逻辑和界面流程下载完毕后,才能首次使用。 |
试试看
请玩转示例应用,查看此 API 的示例用法。
准备工作
请务必在您的项目级
build.gradle
文件中的 buildscript 和 allprojects 部分添加 Google 的 Maven 制品库。将机器学习套件文档扫描器库的依赖项添加到模块的应用级 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 启动扫描程序 activity。
文档扫描完成后,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)。