Flutter文档识别与验证插件acuant_platform_interface的使用

Flutter文档识别与验证插件acuant_platform_interface的使用

简介

acuant_platform_interface 是 acuant_flutter 插件的核心接口。它定义了与文档识别和验证相关的功能，允许开发者通过 Flutter 应用程序调用这些功能。

获取开始

要开始使用 acuant_platform_interface，首先需要在你的 Flutter 项目中集成该插件。以下是完整的步骤和示例代码。

步骤 1: 添加依赖

在项目的 pubspec.yaml 文件中添加 acuant_flutter 依赖：

dependencies:
  acuant_flutter: ^版本号

然后运行以下命令以安装依赖：

flutter pub get

步骤 2: 初始化插件

在应用启动时初始化 acuant_flutter 插件。通常在 main.dart 中进行初始化。

import 'package:flutter/material.dart';
import 'package:acuant_flutter/acuant_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await AcuantFlutter.initialize(apiKey: "your_api_key", tenantId: "your_tenant_id");
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: DocumentScannerPage(),
    );
  }
}

说明：

• apiKey 和 tenantId 是从 Acuant 平台获取的凭据。
• AcuantFlutter.initialize 方法用于初始化插件。

步骤 3: 扫描文档

创建一个页面用于扫描文档，并调用插件的功能。

import 'package:flutter/material.dart';
import 'package:acuant_flutter/acuant_flutter.dart';

class DocumentScannerPage extends StatefulWidget {
  @override
  _DocumentScannerPageState createState() => _DocumentScannerPageState();
}

class _DocumentScannerPageState extends State<DocumentScannerPage> {
  String _result = "等待扫描...";

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("文档识别与验证"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                // 启动文档扫描
                final result = await AcuantFlutter.startDocumentCapture();
                setState(() {
                  _result = result;
                });
              },
              child: Text("扫描文档"),
            ),
            SizedBox(height: 20),
            Text(_result),
          ],
        ),
      ),
    );
  }
}

说明：

• AcuantFlutter.startDocumentCapture() 方法启动文档扫描流程。
• 扫描完成后，结果将通过回调返回到 _result 变量中。

步骤 4: 查看扫描结果

扫描完成后，结果将包含文档信息（如姓名、身份证号等）。你可以根据需要解析和展示这些信息。

// 假设扫描结果如下
String _result = """
{
  "firstName": "张",
  "lastName": "三",
  "documentNumber": "123456789",
  "expiryDate": "2025-12-31"
}
""";

你可以解析 JSON 数据并展示给用户：

Text(_result.isNotEmpty
    ? "姓名: ${jsonDecode(_result)['firstName']} ${jsonDecode(_result)['lastName']}\n"
        "证件号: ${jsonDecode(_result)['documentNumber']}\n"
        "有效期: ${jsonDecode(_result)['expiryDate']}"
    : "未检测到结果")