|
1 | | -# Scanbot Barcode & Document Scanning Example App for Android |
| 1 | +<p align="left"> |
| 2 | + <img src=".images/ScanbotSDKLogo.png#gh-light-mode-only" width="15%" /> |
| 3 | +</p> |
| 4 | +<p align="left"> |
| 5 | + <img src=".images/ScanbotSDKLogo_darkmode.png#gh-dark-mode-only" width="15%" /> |
| 6 | +</p> |
2 | 7 |
|
3 | | -This example app shows how to integrate the [Scanbot Barcode Scanner SDK](https://scanbot.io/developer/android-barcode-scanner/), [Scanbot Document Scanner SDK](https://scanbot.io/developer/android-document-scanner-sdk/), and [Scanbot Data Capture SDK](https://scanbot.io/developer/android-data-capture/) for Android. |
| 8 | +# Example app for the Scanbot Android Document Scanner SDK and Data Capture Modules |
| 9 | + |
| 10 | +This example app shows how to integrate the [Scanbot Document Scanner SDK](https://scanbot.io/document-scanner-sdk/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) and [Scanbot Data Capture Modules](https://scanbot.io/data-capture-software/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) for Android. |
4 | 11 |
|
5 | 12 | ## What is the Scanbot SDK? |
6 | 13 |
|
7 | | -The Scanbot SDK lets you integrate barcode & document scanning, as well as data extraction functionalities, into your mobile apps and website. It contains different modules that are licensable for an annual fixed price. For more details, visit our website https://scanbot.io. |
| 14 | +The Scanbot SDK is a set of high-level APIs that lets you integrate document scanning and data extraction functionalities into your mobile apps and websites. It runs on all common mobile devices and operates entirely offline. No data is transmitted to our or third-party servers. |
| 15 | + |
| 16 | +With our Ready-To-Use UI (RTU UI) components, you can integrate the Scanbot SDK into your app in less than an hour. |
| 17 | + |
| 18 | +💡 For more details about the Scanbot Document Scanner SDK and Data Capture Modules, please check out our [documentation](https://docs.scanbot.io/document-scanner-sdk/android/introduction/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites). |
| 19 | + |
| 20 | +## How to run this example app? |
| 21 | + |
| 22 | +Make sure you have the latest stable version of [Android Studio](https://developer.android.com/studio) installed. |
| 23 | + |
| 24 | +1. Clone this repository to a local folder. |
| 25 | + |
| 26 | +2. There are 3 separate folders with standalone examples: |
| 27 | + |
| 28 | + * **classic-components-example**: Example project for the Scanbot SDK Classic Components which allow for full customization. |
| 29 | + * **document-scanner-ready-to-use-ui-example:** Example project for the Scanbot Document Scanner SDK using our Ready-To-Use UI components. |
| 30 | + * **data-capture-ready-to-use-ui-example**: Example project showcasing the Scanbot Data Capture Modules using our Ready-to-Use UI components. |
| 31 | + |
| 32 | +3. Open one of the 3 separate projects in Android Studio, build, and run. |
| 33 | + |
| 34 | +## Overview of the Scanbot SDK |
| 35 | + |
| 36 | +### Document Scanner SDK |
| 37 | + |
| 38 | +The Scanbot Android Document Scanner SDK offers the following features: |
| 39 | + |
| 40 | +* **User guidance**: Ease of use is crucial for large user bases. Our on-screen user guidance helps even non-tech-savvy users create perfect scans. |
| 41 | + |
| 42 | +* **Automatic capture**: The SDK automatically captures the document when the device is optimally positioned over the document. This reduces the risk of blurry or incomplete document scans compared to manually triggered capture. |
| 43 | + |
| 44 | +* **Automatic cropping**: Our document scanning SDK automatically straightens and crops scanned documents, ensuring high-quality document scan results. |
| 45 | + |
| 46 | +* **Custom filters:** Every document scanning use case has specific image requirements. With the SDK’s custom filters, you can tailor the document scanning image output to your backend system. They include grayscale options, multiple binarizations, and other settings to optimize your document scanning for various document types. |
| 47 | + |
| 48 | +* **Document Quality Analyzer:** This feature automatically rates the quality of the scanned pages from “very poor” to “excellent.” If the quality is below a specified threshold, the SDK prompts the user to rescan. |
| 49 | + |
| 50 | +* **Export formats:** The Scanbot Document Scanner SDK supports several output formats for exporting digitized documents (JPG, PDF, TIFF, and PNG). This ensures your downstream solutions receive the best format to store, print, or share the digitized document – or to process it further. |
| 51 | + |
| 52 | +|  |  |  | |
| 53 | +| :-- | :-- | :-- | |
| 54 | + |
| 55 | +### Data Capture Modules |
| 56 | + |
| 57 | +The Scanbot SDK Data Capture Modules allow you to extract data from a wide range of structured documents and to integrate OCR text recognition capabilities. They include: |
| 58 | + |
| 59 | +#### [MRZ Scanner](https://scanbot.io/data-capture-software/mrz-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) |
| 60 | +This module allows quick and accurate data extraction from the machine-readable zones on identity documents. It captures all important MRZ data from IDs and passports and returns it in the form of simple key-value pairs. This is much simpler, faster, and less mistake-prone than manual data entry. |
| 61 | + |
| 62 | +#### [Check Scanner (MICR)](https://scanbot.io/data-capture-software/check-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) |
| 63 | +The MICR Scanner offers reliable data extraction from international paper checks, capturing check numbers, routing numbers, and account numbers from MICR codes. This simplifies workflows and reduces errors that frustrate customers and employees. |
| 64 | + |
| 65 | +#### [Text Pattern Scanner](https://scanbot.io/data-capture-software/data-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) |
| 66 | +Our Text Pattern Scanner allows quick and accurate extraction of single-line data. It captures information based on customizable patterns tailored to your specific use case. This replaces error-prone manual data entry with automatic capture. |
| 67 | + |
| 68 | +#### [VIN Scanner](https://scanbot.io/data-capture-software/vin-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) |
| 69 | +The VIN scanner enables instant capture of vehicle identification numbers (VINs) from trucks or car doors. It uses OCR to convert the image of the VIN code into structured data for backend processing. This module integrates into mobile or web-based fleet management applications, enabling you to replace error-prone manual entry with fast, reliable data extraction. |
| 70 | + |
| 71 | +#### Document Data Extractor |
| 72 | +Through this feature, our SDK offers document detection and data capture capabilities for a wider range of documents. It accurately identifies and crops various standardized document types including [German ID cards](https://scanbot.io/data-capture-software/id-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites), passports, [driver's licenses](https://scanbot.io/data-capture-software/german-drivers-license-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites), [residence permits](https://scanbot.io/data-capture-software/residence-permit-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites), and the [EHIC](https://scanbot.io/data-capture-software/ehic-scanner/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites). It uses the Scanbot OCR engine for accurate data field recognition, without requiring additional OCR language files. |
| 73 | + |
| 74 | +|  |  |  | |
| 75 | +| :-- | :-- | :-- | |
| 76 | + |
| 77 | +## Additional information |
| 78 | + |
| 79 | +### Free integration support |
| 80 | + |
| 81 | +Need help integrating or testing our Document Scanner SDK? We offer [free developer support](https://docs.scanbot.io/support/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) via Slack, MS Teams, or email. |
| 82 | + |
| 83 | +As a customer, you also get access to a dedicated support Slack or Microsoft Teams channel to talk directly to your Customer Success Manager and our engineers. |
8 | 84 |
|
| 85 | +### Trial licensing and pricing |
9 | 86 |
|
10 | | -## Trial License |
| 87 | +The Scanbot SDK examples will run one minute per session without a license. After that, all functionalities and UI components will stop working. |
11 | 88 |
|
12 | | -The Scanbot SDK will run without a license for one minute per session! |
| 89 | +To try the Scanbot SDK without a one-minute limit, you can request a free, no-strings-attached [7-day trial license](https://scanbot.io/trial/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites). |
13 | 90 |
|
14 | | -After the trial period has expired, all SDK functions and UI components will stop working. You have to restart the app to get another one-minute trial period. |
| 91 | +Alternatively, check out our [demo apps](https://scanbot.io/demo-apps/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) to test the SDK. |
15 | 92 |
|
16 | | -To try the Scanbot SDK without a one-minute limit, you can get a free “no-strings-attached” trial license. Please submit the [Trial License Form](https://scanbot.io/trial/) on our website. |
| 93 | +Our pricing model is simple: Unlimited document scanning for a flat annual license fee, full support included. There are no tiers, usage charges, or extra fees. [Contact](https://scanbot.io/contact-sales/?utm_source=github.com&utm_medium=referral&utm_campaign=dev_sites) our team to receive your quote. |
17 | 94 |
|
18 | | -## Free Developer Support |
| 95 | +### Other supported platforms |
19 | 96 |
|
20 | | -We provide free "no-strings-attached" developer support for the implementation & testing of the Scanbot SDK. |
21 | | -If you encounter technical issues with integrating the Scanbot SDK or need advice on choosing the appropriate |
22 | | -framework or features, please visit our [Support Page](https://docs.scanbot.io/support/). |
| 97 | +Besides Android, the Scanbot SDK is also available on iOS and most common cross-platform environments, such as React Native, Flutter, or .NET MAUI: |
23 | 98 |
|
24 | | -## Documentation |
| 99 | +* [iOS](https://github.com/doo/scanbot-sdk-example-ios) (native) |
| 100 | +* [JavaScript](https://github.com/doo/scanbot-sdk-example-web) |
| 101 | +* [Flutter](https://github.com/doo/scanbot-sdk-example-flutter) |
| 102 | +* [Capacitor & Ionic (Angular)](https://github.com/doo/scanbot-sdk-example-capacitor-ionic) |
| 103 | +* [Capacitor & Ionic (React)](https://github.com/doo/scanbot-sdk-example-ionic-react) |
| 104 | +* [Capacitor & Ionic (Vue.js)](https://github.com/doo/scanbot-sdk-example-ionic-vuejs) |
| 105 | +* [Cordova & Ionic](https://github.com/doo/scanbot-sdk-example-ionic) |
| 106 | +* [.NET MAUI](https://github.com/doo/scanbot-sdk-maui-example) |
| 107 | +* [React Native](https://github.com/doo/scanbot-sdk-example-react-native) |
| 108 | +* [Xamarin](https://github.com/doo/scanbot-sdk-example-xamarin) & [Xamarin.Forms](https://github.com/doo/scanbot-sdk-example-xamarin-forms) |
25 | 109 |
|
26 | | -- [Developer Guide](https://docs.scanbot.io/document-scanner-sdk/android/introduction/) |
27 | | -- [API Docs](https://scanbotsdk.github.io/documentation/android/api/) |
| 110 | +Our Barcode Scanner SDK additionally also supports [Compose Multiplatform / KMP](https://github.com/doo/scanbot-barcode-scanner-sdk-example-kmp), [UWP](https://github.com/doo/scanbot-barcode-scanner-sdk-example-windows) (Windows), and [Linux](https://github.com/doo/scanbot-sdk-example-linux). |
0 commit comments