סורק מסמכים עם ערכת ML ב-Android
השתמשו ב-ML Kit Document Scanner API כדי להוסיף בקלות תכונה של סורק מסמכים לאפליקציה שלכם.
Feature | פרטים |
---|---|
שם ה-Sdk | play-services-mlkit-document-scanner |
הטמעה | שירותי Google Play מבצעים הורדה דינמית של המודלים, לוגיקת הסריקה וזרימת ממשק המשתמש. |
ההשפעה של גודל האפליקציה | גודל הורדה של כ-300KB. |
זמן אתחול | יכול להיות שהמשתמשים יצטרכו להמתין עד להורדת המודלים, הלוגיקה ותהליך ממשק המשתמש לפני השימוש הראשון. |
אני רוצה לנסות
קראו את האפליקציה לדוגמה כדי לראות דוגמה לשימוש ב-API הזה.
לפני שמתחילים
בקובץ
build.gradle
ברמת הפרויקט, חשוב לכלול את מאגר Maven של Google בקטע של ה-buildscript ושל כל הפרויקטים.מוסיפים את התלות של ספריית סורק המסמכים של 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
. לאחר מכן אפשר להתחיל את פעילות הסורק אחרי הממשקים של ממשקי API של תוצאות פעילות שהוצגו ב-AndroidX.
כשסריקת המסמך מסתיימת, אובייקט 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 { ... }
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, או שניהם) הנדרשים לכם בפועל.