flutter_ocr_sdk
A wrapper for Dynamsoft OCR SDK with MRZ detection model. It helps developers build Flutter applications to detect machine-readable zones (MRZ) in passports, travel documents, and ID cards.
Try MRZ Detection Example
Mobile: Android and iOS
cd example
flutter run
Web
cd example
flutter run -d chrome
Desktop: Windows and Linux
cd example
flutter run -d windows
# flutter run -d linux
Supported Platforms
- Android
- Web
- Windows
- Linux
- iOS
Installation
Add flutter_ocr_sdk
as a dependency in your pubspec.yaml
file.
dependencies:
...
flutter_ocr_sdk:
One More Step for Web
Include the JavaScript library of Dynamsoft Label Recognizer in your index.html
file:
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-label-recognizer@2.2.31/dist/dlr.js"></script>
API Compatibility
Methods | Android | iOS | Windows | Linux | macOS | Web |
---|---|---|---|---|---|---|
Future<int?> init(String key) |
:heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
Future<int?> loadModel() |
:heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
Future<List<List<MrzLine>>?> recognizeByFile(String filename) |
:heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
Future<List<List<MrzLine>>?> recognizeByBuffer(Uint8List bytes, int width, int height, int stride, int format) |
:heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
Usage
-
Initialize the MRZ detector with a valid license key:
FlutterOcrSdk _mrzDetector = FlutterOcrSdk(); int? ret = await _mrzDetector.init( "DLS2eyJoYW5kc2hha2VDb2RlIjoiMjAwMDAxLTE2NDk4Mjk3OTI2MzUiLCJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSIsInNlc3Npb25QYXNzd29yZCI6IndTcGR6Vm05WDJrcEQ5YUoifQ==");
-
Load the MRZ detection model:
await _mrzDetector.loadModel();
-
Recognize MRZ from an image file:
List<List<MrzLine>>? results = await _mrzDetector.recognizeByFile(photo.path);
-
Recognize MRZ from an image buffer:
ui.Image image = await decodeImageFromList(fileBytes); ByteData? byteData = await image.toByteData(format: ui.ImageByteFormat.rawRgba); List<List<MrzLine>>? results = await _mrzDetector.recognizeByBuffer( byteData.buffer.asUint8List(), image.width, image.height, byteData.lengthInBytes ~/ image.height, ImagePixelFormat.IPF_ARGB_8888.index);
-
Parse MRZ information:
String information = ''; if (results != null && results.isNotEmpty) { for (List<MrzLine> area in results) { if (area.length == 2) { information = MRZ.parseTwoLines(area[0].text, area[1].text).toString(); } else if (area.length == 3) { information = MRZ .parseThreeLines(area[0].text, area[1].text, area[2].text) .toString(); } } }
Libraries
- flutter_ocr_sdk
- flutter_ocr_sdk_method_channel
- flutter_ocr_sdk_platform_interface
- flutter_ocr_sdk_web
- mrz_line
- mrz_parser
- mrz_result
- shims/dart_js_util
- shims/dart_ui
- This file shims dart:ui in web-only scenarios, getting rid of the need to suppress analyzer warnings.
- shims/dart_ui_fake
- shims/dart_ui_real
- utils
- web_dlr_manager