Android에서 ML Kit를 사용한 문서 스캐너
ML Kit 문서 스캐너 API를 사용하여 문서 스캐너 기능을 있습니다.
기능 | 세부정보 |
---|---|
SDK 이름 | play-services-mlkit-document-scanner |
구현 | 모델, 스캔 로직, UI 흐름은 Google Play 서비스에 의해 동적으로 다운로드됩니다. |
앱 크기 영향 | 다운로드 크기가 300KB까지 늘어납니다. |
초기화 시간 | 사용자는 모델, 로직, UI 흐름이 다운로드하시기 바랍니다. |
사용해 보기
샘플 앱을 사용해 이 API의 사용 예를 살펴보세요.
시작하기 전에
프로젝트 수준
build.gradle
파일의 buildscript 및 allprojects 섹션에 Google의 Maven 저장소가 포함되어야 합니다.모듈의 앱 수준 Gradle 파일(일반적으로 app/build.gradle)에 ML Kit 문서 스캐너 라이브러리의 종속 항목을 추가합니다.
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()
자바
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
소개하겠습니다.
문서 스캔이 완료되면 GmsDocumentScanningResult
객체가 스캔된 페이지 수, 문서의 URI,
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 { ... }
자바
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 또는 둘 다)만 요청하세요.