Flutter OCR识别插件mnc_identifier_ocr的使用

Flutter OCR识别插件mnc_identifier_ocr的使用

MNC Identifier OCR

这是一个用于Android和iOS平台扫描印尼身份证（KTP）的Flutter插件。

安装

添加依赖

你可以使用以下命令添加MNC Identifier OCR作为依赖项，使用最新稳定版本：

$ dart pub add mnc_identifier_ocr

或者你可以手动将MNC Identifier OCR添加到pubspec.yaml文件的依赖部分：

dependencies:
  mnc_identifier_ocr: ^1.0.20

最新的版本是：1.0.20

额外步骤

Android

该插件需要Android SDK 21或更高版本。

在你的AndroidManifest.xml中添加CaptureOCRActivity：

<activity android:name="id.mncinnovation.ocr.CaptureOCRActivity" android:theme="@style/Theme.AppCompat.Light.NoActionBar" />

iOS

该插件需要iOS 11.0或更高版本。

在你的info.plist文件中添加NSCameraUsageDescription键。描述你的应用程序为什么需要访问相机。这在可视化编辑器中被称为隐私 - 相机使用描述。

使用方法

以下是使用mnc_identifier_ocr插件进行KTP扫描的示例代码：

import 'package:mnc_identifier_ocr/mnc_identifier_ocr.dart';
import 'package:mnc_identifier_ocr/model/ocr_result_model.dart';

...

Future<void> scanKtp() async {
    try {
      // 调用插件开始扫描KTP，启用闪光灯并且只使用相机
      OcrResultModel res = await MncIdentifierOcr.startCaptureKtp(withFlash: true, cameraOnly: true);
      debugPrint('result: ${res.toString()}');
    } catch (e) {
      debugPrint('something goes wrong $e');
    }
}

注意：在iOS上，这个插件只能在真实设备上工作。

示例Demo

下面是一个完整的Flutter应用示例，展示如何使用mnc_identifier_ocr插件进行KTP扫描：

import 'package:flutter/material.dart';
import 'package:image_picker/image_picker.dart';
import 'dart:async';
import 'package:mnc_identifier_ocr/mnc_identifier_ocr.dart';
import 'package:mnc_identifier_ocr/model/ocr_result_model.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  OcrResultModel? result;

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> scanKtp() async {
    OcrResultModel? res;
    try {
      // 开始扫描KTP，启用闪光灯并且只使用相机
      res = await MncIdentifierOcr.startCaptureKtp(withFlash: true, cameraOnly: true);
    } catch (e) {
      debugPrint('something goes wrong $e');
    }

    if (!mounted) return;

    setState(() {
      result = res;
    });
  }

  // 从图库选择图片
  _imgGlr() async {
    final XFile? image = await ImagePicker().pickImage(source: ImageSource.gallery);
    debugPrint('path: ${image?.path}');
  }

  // 从相机拍摄图片
  _imgCmr() async {
    final XFile? image = await ImagePicker().pickImage(source: ImageSource.camera);
    debugPrint('path: ${image?.path}');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Stack(
          children: [
            Text('Ktp data: ${result?.toJson()}'),
            Center(
              child: Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  // 按钮触发KTP扫描
                  ElevatedButton(onPressed: scanKtp, child: const Text('PUSH HERE')),
                  const SizedBox(height: 8),
                  // 按钮打开相机
                  ElevatedButton(onPressed: _imgCmr, child: const Text('CAMERA')),
                  const SizedBox(height: 8),
                  // 按钮打开图库
                  ElevatedButton(onPressed: _imgGlr, child: const Text('GALLERY')),
                ],
              ),
            ),
          ],
        ),
      ),
    );
  }
}