Flutter泰国银行卡读取插件acs_card_reader_thailand的使用

Flutter泰国银行卡读取插件acs_card_reader_thailand的使用

简介

Flutter ThaiNationalIDCard 是一个专为 Flutter 开发设计的插件，主要用于读取泰国身份证卡信息。此插件基于原始代码进一步开发，支持通过特定设备读取泰国身份证卡的详细信息。

支持设备:

• acs acr39u icc reader

支持操作系统:

• Android

错误消息响应

以下是可能出现的错误代码及对应的含义：

• 0 → 打开任务时设备出错
• 1 → 卡片未牢固插入
• 2 → 设备权限被拒绝
• 3 → 设备不支持
• 4 → 未找到设备

APDU 命令

获取响应

命令格式：0x00, 0xC0, 0x00, 0x00 + Len in hex

指令说明

• INS 0xB0 | 读取BIN数据
• INS 0xC0 | 获取响应

SELECT FILE

• CLA = 0X00
• INS = 0XA4
• P1 = 0x04 | 直接选择文件名（数据字段为文件名）
• P2 = 0x00
• Lc = 0x08 (文件名长度)
• Thailand Personal DF Name = 0xA0, 0X00, 0x00, 0x00, 0x54, 0x48, 0x00, 0x01

数据表

使用示例

以下是一个完整的示例代码，展示如何使用 acs_card_reader_thailand 插件来读取泰国身份证卡信息。

import 'dart:convert';

import 'package:acs_card_reader_thailand/model/personalInformation.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:acs_card_reader_thailand/acs_card_reader_thailand.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> {
  String _platformVersion = 'Unknown';
  bool isCheck_btn = true;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 初始化平台状态
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await AcsCardReaderThailand.platformVersion ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }
    if (!mounted) return;
    setState(() {
      _platformVersion = platformVersion;
    });
  }

  late PersonalInformation personalInformation = PersonalInformation(status: false);

  // 连接设备并读取信息
  onConnectDevice() async {
    AcsCardReaderThailand.messageStream.listen((event) async {
      if (event) {
        if (isCheck_btn) {
          isCheck_btn = false;
          setState(() {});
          personalInformation = await AcsCardReaderThailand.acsCardID();
          isCheck_btn = true;
          setState(() {});
        }
      } else {
        isCheck_btn = true;
        personalInformation = PersonalInformation(status: false);
        setState(() {});
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    onConnectDevice();
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Thai ID Card Reader'),
        ),
        body: Center(
          child: Container(
            width: 250,
            child: SingleChildScrollView(
              child: Column(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  // 显示用户头像
                  personalInformation.status! ? getImagenBase64(personalInformation.PictureSubFix.toString()) : SizedBox(),
                  SizedBox(height: 20,),
                  // 显示泰文姓名
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('NameTH ')),
                      Expanded(flex: 2, child: Text('${personalInformation.nameTH ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示英文姓名
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('NameEN ')),
                      Expanded(flex: 2, child: Text('${personalInformation.nameEN ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示出生日期
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('BirthDate ')),
                      Expanded(flex: 2, child: Text('${personalInformation.birthDate ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示身份证号
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('IDCard ')),
                      Expanded(flex: 2, child: Text('${personalInformation.personalID ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示性别
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('Gender ')),
                      Expanded(flex: 2, child: Text('${personalInformation.gender == 1 ? 'ชาย' : personalInformation.gender == 2 ? 'หญิง' : '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示地址
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('Adress ')),
                      Expanded(flex: 2, child: Text('${personalInformation.address ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示发卡机构
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('CardIssuer ')),
                      Expanded(flex: 2, child: Text('${personalInformation.CardIssuer ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示发卡日期
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('IssueDate ')),
                      Expanded(flex: 2, child: Text('${personalInformation.IssueDate ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示有效期
                  Row(
                    mainAxisAlignment: MainAxisAlignment.start,
                    children: [
                      Expanded(child: Text('ExpireDate ')),
                      Expanded(flex: 2, child: Text('${personalInformation.ExpireDate ?? '-------------------- -------------------'}')),
                    ],
                  ),
                  // 显示消息码
                  SizedBox(height: 1,),
                  Text("Message_code -> ${personalInformation.Message_code}"),
                  SizedBox(height: 20,),
                  // 扫描按钮
                  TextButton(
                    style: ButtonStyle(
                      backgroundColor: MaterialStateProperty.all(isCheck_btn ? Colors.blueAccent : Colors.grey.shade400),
                    ),
                    onPressed: () async {
                      if (isCheck_btn) {
                        isCheck_btn = false;
                        setState(() {});
                        personalInformation = await AcsCardReaderThailand.acsCardID();
                        isCheck_btn = true;
                        setState(() {});
                      }
                    },
                    child: Text("Scan Now CardID",
                      style: TextStyle(color: Colors.white),)),
                ],
              ),
            ),
          ),
        ),
      ),
    );
  }

  // 将Base64编码转换为图像
  Widget getImagenBase64(String imagen) {
    const Base64Codec base64 = Base64Codec();
    if (personalInformation.status == false) return new Container(
      padding: EdgeInsets.all(20),
      color: Colors.grey.shade400,
      child: Icon(Icons.person_add, size: 100, color: Colors.grey.shade500,),
    );

    return Image.memory(
      base64.decode(imagen),
      fit: BoxFit.fitWidth,
    );
  }
}