Flutter身份证信息解析插件mrz_parser的使用

发布于 1周前 作者 sinazl 来自 Flutter

Flutter身份证信息解析插件mrz_parser的使用

mrz_parser 是一个用于解析身份文档中机器可读区域（MRZ）的Dart/Flutter插件。该插件受到 QKMRZParser 的启发，支持多种格式的MRZ解析。

支持的格式

  • TD1
  • TD2
  • TD3
  • MRV-A
  • MRV-B

使用方法

1. 导入插件

首先，在 pubspec.yaml 文件中添加对 mrz_parser 的依赖：

dependencies:
    mrz_parser: ^2.0.0

然后运行 flutter pub get 来安装插件。

2. 解析MRZ

可以使用 MRZParser.tryParse 方法来尝试解析MRZ字符串，或者使用 MRZParser.parse 并捕获可能的异常。

示例代码：

import 'package:mrz_parser/mrz_parser.dart';

void main() {
  // 示例MRZ数据
  final mrz = [
    'P<UTOERIKSSON<<ANNA<MARIA<<<<<<<<<<<<<<<<<<<<',
    'L898902C36UTO7408122F1204159ZE184226B<<<<<<10'
  ];

  // 尝试解析MRZ
  final result = MRZParser.tryParse(mrz);

  if (result != null) {
    print('Document Type: ${result.documentType}'); // 'P'
    print('Country Code: ${result.countryCode}'); // 'UTO'
    print('Surnames: ${result.surnames}'); // 'ERIKSSON'
    print('Given Names: ${result.givenNames}'); // 'ANNA MARIA'
    print('Document Number: ${result.documentNumber}'); // 'L898902C3'
    print('Nationality Country Code: ${result.nationalityCountryCode}'); // 'UTO'
    print('Birth Date: ${result.birthDate}'); // DateTime(1974, 08, 12)
    print('Sex: ${result.sex}'); // Sex.female
    print('Expiry Date: ${result.expiryDate}'); // DateTime(2012, 04, 15)
    print('Personal Number: ${result.personalNumber}'); // 'ZE184226B'
    print('Personal Number 2: ${result.personalNumber2}'); // null
  } else {
    print('Failed to parse MRZ.');
  }

  // 使用parse方法并捕获异常
  try {
    final result = MRZParser.parse(mrz);
    print(result?.documentType); // 'P'
  } on MRZException catch (e) {
    print('Error parsing MRZ: $e');
  }
}

作者

许可证

mrz_parser 在 MIT License 下发布。详细信息请参见 LICENSE。


这个Markdown文档提供了完整的 `mrz_parser` 插件的使用示例，包括如何导入插件、解析MRZ以及处理解析结果。希望这对你有所帮助！

更多关于Flutter身份证信息解析插件mrz_parser的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter身份证信息解析插件mrz_parser的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用mrz_parser插件来解析身份证（通常是护照或身份证上的机器可读区域，MRZ）信息的示例代码。

首先，确保你已经在pubspec.yaml文件中添加了mrz_parser依赖：

dependencies:
  flutter:
    sdk: flutter
  mrz_parser: ^最新版本号 # 请替换为实际发布的最新版本号

然后运行flutter pub get来获取依赖。

接下来，在你的Flutter项目中，你可以使用以下代码来解析MRZ信息。以下是一个完整的示例，包括UI和解析逻辑：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'MRZ Parser Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _controller = TextEditingController();
  String _parsedResult = '';

  void _parseMRZ() async {
    String mrzData = _controller.text;
    try {
      // 假设这是一个TD1类型的护照MRZ（上两行，每行30个字符）
      MRZResult result = await MRZParser.parseTD1(mrzData);
      
      // 设置解析结果
      setState(() {
        _parsedResult = '''
Name: ${result.surname}, ${result.givenNames}
Date of Birth: ${result.dateOfBirth}
Nationality: ${result.nationality}
Document Number: ${result.documentNumber}
Document Type: ${result.documentType}
Gender: ${result.gender}
Optional Data: ${result.optionalData}
Check Digit: ${result.checkDigit}
        ''';
      });
    } catch (e) {
      // 处理解析错误
      setState(() {
        _parsedResult = 'Error parsing MRZ: $e';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('MRZ Parser Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: <Widget>[
            TextField(
              controller: _controller,
              maxLines: 6,
              keyboardType: TextInputType.multiline,
              decoration: InputDecoration(
                labelText: 'Enter MRZ Data',
                helperText: 'Paste your MRZ data here (6 lines for TD3, 2 lines for TD1/TD2)',
              ),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _parseMRZ,
              child: Text('Parse MRZ'),
            ),
            SizedBox(height: 20),
            Text(
              _parsedResult,
              style: TextStyle(fontSize: 16),
            ),
          ],
        ),
      ),
    );
  }
}

解释

  1. 依赖添加：在pubspec.yaml中添加mrz_parser依赖。
  2. UI设计：使用TextField来输入MRZ数据，ElevatedButton来触发解析操作，Text来显示解析结果。
  3. 解析逻辑：在_parseMRZ方法中，使用MRZParser.parseTD1（或其他适用的解析方法，如parseTD2或parseTD3）来解析输入的MRZ数据。根据解析结果更新UI。

注意

  • 确保你输入的MRZ数据格式正确，例如TD1类型通常是两行，每行30个字符。
  • mrz_parser插件可能支持不同类型的MRZ，具体请参考插件的文档。
  • 错误处理是必需的，因为用户可能会输入无效或格式不正确的数据。

通过上述代码，你可以在Flutter应用中实现一个简单的MRZ解析功能。

回到顶部