Android 上带有机器学习套件的文档扫描器
使用机器学习套件文档扫描器 API 轻松将文档扫描器功能添加到 。
功能 | 详细信息 |
---|---|
SDK 名称 | play-services-mlkit-document-scanner |
实现 | 模型、扫描逻辑和界面流程由 Google Play 服务。 |
应用大小影响 | 下载大小增加约 300KB。 |
初始化时间 | 用户可能必须等待模型、逻辑和界面流程 请在首次使用前下载。 |
试试看
玩转 示例应用 查看此 API 的用法示例。
准备工作
请务必在您的项目级
build.gradle
文件中添加 Google 的 buildscript 和所有项目部分中的 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
的实例。然后,您可以启动扫描器活动
正在关注
Activity Result API
是 AndroidX 中引入的。
文档扫描完成后,GmsDocumentScanningResult
对象将授予以下权限:扫描的页数、
JPEG 格式和 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), 。