Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Scanner
La digitalizzazione di documenti fisici, che consente agli utenti di convertirli
in formati digitali, è diventata un percorso molto comune degli utenti nelle app mobile.
L'API Document Scanner di ML Kit offre una soluzione completa con un flusso di UI coerente e di alta qualità in app e dispositivi Android. Una volta attivato il flusso dello scanner di documenti dall'app, gli utenti mantengono il controllo completo sul processo di scansione. Facoltativamente, possono ritagliare i documenti scansionati, applicare filtri, rimuovere ombre o macchie e inviare facilmente i file digitalizzati alla tua app.
Il flusso di UI, i modelli ML e altre risorse di grandi dimensioni vengono distribuiti tramite Google Play Services, il che significa che:
Impatto ridotto sulle dimensioni dei file binari (tutti i modelli ML e le risorse di grandi dimensioni vengono scaricati centralmente in Google Play Services).
Non è necessaria alcuna autorizzazione di accesso alla fotocamera: lo scanner di documenti sfrutta l'autorizzazione di accesso alla fotocamera di Google Play Services e gli utenti possono stabilire quali file condividere con la tua app.
L'intero flusso dello scanner di documenti funziona sul dispositivo.
Interfaccia utente coerente e di alta qualità per la digitalizzazione di documenti fisici.
Acquisizione automatica con rilevamento dei documenti.
Rilevamento accurato dei bordi per risultati di ritaglio ottimali.
Rilevamento automatico della rotazione per mostrare i documenti in posizione verticale.
Funzionalità di modifica per ritagliare, applicare filtri, rimuovere ombre, pulire
le macchie e inviare facilmente file digitalizzati alla tua app.
Elaborazione sul dispositivo per preservare la privacy dell'utente.
Non è necessaria l'autorizzazione di accesso alla fotocamera dalla tua app.
Impatto ridotto sulle dimensioni binarie dell'APK.
Funzionalità di
L'API Document Scanner fornisce un flusso UI completo e di alta qualità coerente in tutte le app per Android. Tuttavia, è possibile anche personalizzare
alcuni aspetti dell'esperienza utente:
Numero massimo di pagine:
Imposta un limite per il numero di pagine scansionate.
Importazione galleria:
Attiva o disattiva la funzionalità di importazione dalla galleria fotografica.
Funzionalità di editing:
personalizza le funzionalità di editing disponibili per l'utente scegliendo tra 3 modalità:
SCANNER_MODE_BASE: funzionalità di modifica di base (ritaglio, rotazione,
riordinamento delle pagine e così via).
SCANNER_MODE_BASE_WITH_FILTER: aggiunge filtri immagine (scala di grigi, miglioramento automatico dell'immagine e così via) alla modalità SCANNER_MODE_BASE.
SCANNER_MODE_FULL (impostazione predefinita): aggiunge funzionalità di pulizia delle immagini abilitate con ML (cancellare macchie, impronte e così via) alla modalità SCANNER_MODE_BASE_WITH_FILTER. Questa modalità consentirà inoltre di aggiungere automaticamente le funzionalità principali future insieme agli aggiornamenti di Google Play Services, mentre le altre due manterranno gli attuali set di funzionalità e riceveranno solo perfezionamenti di minore entità.
Modalità di base
Modalità di base con filtro
Modalità completa
Risultati di esempio
Immagine originale
Documento digitalizzato con prospettiva corretta, pieghe rimosse e filtro Scala di grigi applicato
Immagine originale
Documento scansionato ruotato automaticamente con rimozione di macchie e filtro colorato applicato
Immagine originale
Documento digitalizzato con macchia rimossa e filtro automatico applicato
Immagine originale
Documento digitalizzato ruotato automaticamente con ombra rimossa e filtro automatico applicato
Immagine originale
Documento scansionato ruotato automaticamente con il dito rimosso e filtro automatico applicato
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eML Kit's Document Scanner API enables digitization of physical documents within Android apps, providing a high-quality and consistent user interface.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers on-device processing, ensuring user privacy and eliminating the need for camera permissions from the app.\u003c/p\u003e\n"],["\u003cp\u003eUsers have control over the scanning process, including cropping, applying filters, removing imperfections, and sharing the digitized files.\u003c/p\u003e\n"],["\u003cp\u003eCustomization options are available to tailor the user experience, such as limiting pages, enabling gallery imports, and adjusting editing functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThe API leverages Google Play services for model delivery, minimizing app size and enabling automatic updates for enhanced features.\u003c/p\u003e\n"]]],["The document scanner API allows users to digitize physical documents within Android apps. Key actions include automatic document capture, edge and rotation detection, and editing features like cropping, filtering, and stain/shadow removal. The API operates on-device and uses Google Play services, ensuring low binary size impact and eliminating the need for camera permissions. Customization options are provided for the maximum number of pages, gallery import, and three editing modes, with the full mode offering the most feature set.\n"],null,["Document scanner\n----------------\n\n| This API is offered in beta, and is not subject to any SLA or deprecation policy. Changes may be made to this API that break backward compatibility.\n\nDigitizing physical documents, which allows users to convert physical documents\ninto digital formats has become a very common user journey in mobile apps.\nML Kit's document scanner API provides a comprehensive solution with a\nhigh-quality, consistent UI flow across Android apps and devices. Once the\ndocument scanner flow is triggered from your app, users retain full control over\nthe scanning process. They can optionally crop the scanned documents, apply\nfilters, remove shadows or stains, and easily send the digitized files back to\nyour app.\n\nThe UI flow, ML models and other large resources are delivered using Google Play\nservices, which means:\n\n- Low binary size impact (all ML models and large resources are downloaded centrally in Google Play services).\n- No camera permission is required - the document scanner leverages the Google Play services' camera permission, and users are in control of which files to share back with your app.\n\nThe entire document scanner flow operates on-device.\n\n[Android](/ml-kit/vision/doc-scanner/android)\n\n### Key capabilities\n\n- High-quality and consistent user interface for digitizing physical documents.\n- Automatic capture with document detection.\n- Accurate edge detection for optimal crop results.\n- Automatic rotation detection to show documents upright.\n- Editing functionalities to crop, apply filters, remove shadows, clean stains, and seamlessly send digitized files back to your app.\n- On-device processing, preserving user's privacy.\n- No camera permission is needed from your app.\n- Low apk binary size impact.\n\n### Customization\n\nThe document scanner API provides a high-quality fully fledged UI flow that is\nconsistent across Android apps. However, there is also room to customize some\naspects of the user experience:\n\n- **Maximum number of pages:** \n\n Set a limit to the number of pages scanned.\n\n- **Gallery import:** \n\n Enable or disable the capability to import from the photo gallery.\n\n- **Editing functionalities:** \n\n Customize the editing functionalities available to the user by choosing\n from 3 modes:\n\n - `SCANNER_MODE_BASE`: basic editing capabilities (crop, rotate, reorder pages, etc...).\n - `SCANNER_MODE_BASE_WITH_FILTER`: adds image filters (grayscale, auto image enhancement, etc...) to the `SCANNER_MODE_BASE` mode.\n - `SCANNER_MODE_FULL` (default): adds ML-enabled image cleaning capabilities (erase stains, fingers, etc...) to the `SCANNER_MODE_BASE_WITH_FILTER` mode. This mode will also allow future major features to be automatically added along with Google Play services updates, while the other two modes will maintain their current feature sets and only receive minor refinements.\n\n| Base mode | Base mode with filter | Full mode |\n|-----------|-----------------------|-----------|\n| | | |\n\n### Example results\n\n| Original picture | Scanned document with perspective corrected, wrinkle removed and grayscale filter applied |\n|------------------|-------------------------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with stain removed and color filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document with stain removed and auto filter applied |\n|------------------|-------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with shadow removed and auto filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |\n\n| Original picture | Scanned document auto-rotated with finger removed and auto filter applied |\n|------------------|---------------------------------------------------------------------------|\n| | |"]]
