blinkid_flutter 6.8.0
blinkid_flutter: ^6.8.0 copied to clipboard
Flutter plugin for BlinkID, SDK for scanning and OCR of various identity documents.
BlinkID SDK Flutter plugin #
AI-driven identity document scanning for Flutter apps.
We made it quick and easy to create a sample application or install the plugin into your existing iOS or Android app.
Please note that, for maximum performance and full access to all features, it’s best to go with one of our native SDKs (for iOS or Android).
However, since the wrapper is open source, you can add the features you need on your own.
Requirements #
BlinkID plugin is developed with Flutter SDK version 1.17.5. For help with Flutter, view official documentation.
Getting Started #
To get started, first create empty project if needed:
flutter create project_name
Add the blinkid_flutter dependency to your pubspec.yaml
file:
dependencies:
...
blinkid_flutter:
Quick start with sample app #
To try BlinkID plugin, you can generate a minimal sample application. To do so run ./initFlutterSample.sh
script.
To run sample application, use the following commands:
cd sample/
flutter run
If there are problems with running the application, please make sure you have
properly configured tools by running flutter doctor
. You can also try running
the application from VSCode, Android Studio or Xcode.
Plugin usage #
- Perform scanning by calling the method
MicroblinkScanner.scanWithCamera()
and passing it theRecognizerCollection
andOverlaySettings
you wish to use, along with your license key. To find out more about licensing, click here.
Future<void> scan() async {
List<RecognizerResult> results;
Recognizer recognizer = BlinkIdMultiSideRecognizer();
OverlaySettings settings = BlinkIdOverlaySettings();
// set your license
if (Theme.of(context).platform == TargetPlatform.iOS) {
license = "";
} else if (Theme.of(context).platform == TargetPlatform.android) {
license = "";
}
try {
// perform scan and gather results
results = await MicroblinkScanner.scanWithCamera(RecognizerCollection([recognizer]), settings, license);
} on PlatformException {
// handle exception
}
- When scanning is completed, variable
results
will contain a list of non-emptyRecognizerResults
from recognizers set inRecognizerCollection
. You can then access each result individually. If the scanning is manually closed, the method will return an empty list.
For more information please refer to our sample application source code.
Available API #
All available recognizers can be found inside BlinkID/lib/recognizers
.
All available overlays can be found inside BlinkID/lib/overlays
.
For 100% of features and maximum control, consider using native SDK.
Platform specifics #
Plugin implementation is in folder lib
, while platform specific implementations are in android
and ios
folders.
Android
Android folder is fully initialized after running ./initFlutterSample.sh
.
iOS
To initialize BlinkID framework for use with iOS, after you've added the dependency to blinkid_flutter
to your pubspec.yaml
, go to NameOfYourProject/ios
and run pod install
.
Our blinkid_flutter
depends on the latest PPBlinkID pod so it will be installed automatically.
To set camera permission usage message, open NameOfYourProject/ios/Runner.xcworkspace
and under Runner/Runner/Info.plist
set
Privacy - Camera Usage Description
.
Licensing #
- A valid license key is required to initialize scanning. You can request a free trial license key, after you register, at Microblink Developer Hub
- Get information about pricing and licensing of BlinkID