Skaner dokumentów z użyciem ML Kit na Androidzie
Użyj interfejsu ML Kit Document Scanner API, aby łatwo dodać funkcję skanera dokumentów do aplikacji.
Funkcja | Szczegóły |
---|---|
Nazwa pakietu SDK | play-services-mlkit-document-scanner |
Implementacja | Usługi Google Play pobierają modele, logikę skanowania i przepływ interfejsu. |
Wpływ na rozmiar aplikacji | Zwiększony rozmiar pobieranego pliku o ok. 300 KB. |
Czas inicjowania | Przed pierwszym użyciem użytkownicy mogą czekać na pobranie modeli, logiki i przepływu interfejsu użytkownika. |
Wypróbuj
Przetestuj przykładową aplikację, aby zobaczyć przykład użycia tego interfejsu API.
Zanim zaczniesz
Pamiętaj, aby w sekcjach kompilacji i allprojects plik
build.gradle
na poziomie projektu uwzględnić repozytorium Google Maven.Dodaj zależność biblioteki skanera dokumentów ML Kit do pliku Gradle na poziomie aplikacji. Zwykle ma on postać app/build.gradle:
dependencies {
// …
implementation 'com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1'
}
Konfiguracja skanera dokumentów
Procedura korzystania ze skanera dokumentów (obejmująca osobny ekran wizjera i ekran podglądu) zapewnia pakiet SDK. Wizjer i ekran podglądu obsługują te elementy sterujące, które można dostosować:
- importowanie z galerii zdjęć
- ustawianie limitu liczby skanowanych stron,
- tryb skanera (do kontrolowania zestawu funkcji w ramach procesu)
Zeskanowane dokumenty możesz pobierać zarówno w formacie PDF, jak i JPEG.
Aby skonfigurować opcje skanera, utwórz instancję 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();
Skanowanie dokumentów
Po utworzeniu GmsDocumentScannerOptions
pobierz wystąpienie GmsDocumentScanner
. Możesz wtedy uruchomić działanie skanera zgodnie z interfejsami Activity Result API wdrożonymi w AndroidzieX.
Po zakończeniu skanowania dokumentu obiekt GmsDocumentScanningResult
przyznaje dostęp do liczby zeskanowanych stron oraz do identyfikatorów URI obrazów w formacie JPEG i PDF odpowiednio do informacji zdefiniowanych w 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(...);
Wskazówki dotyczące poprawy skuteczności
Pamiętaj, że generowanie plików dokumentów jest czasochłonne i wymaga mocy obliczeniowej. Dlatego wysyłaj żądania tylko w formatach wyjściowych (JPEG, PDF lub obu), które są Ci potrzebne.