huangsheng/idcard
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init

Browse Source
This commit is contained in:
leon
2026-03-31 08:51:00 +08:00
commit 12d21c4c90
71 changed files with 4529 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

276
lib/idcard_platform_interface.dart Normal file
View File

@@ -0,0 +1,276 @@
import 'package:plugin_platform_interface/plugin_platform_interface.dart';
import 'idcard_method_channel.dart';
/// 身份证信息数据模型
class IdCardInfo {
final String cardType; // 证件类型 (A-二代证, I/Y-外国人, J-港澳台)
final String name; // 中文姓名
final String nameEn; // 英文姓名
final String gender; // 性别
final String genderId; // 性别代码
final String nation; // 民族/国籍
final String nationId; // 民族代码/国籍代码/通行证号码
final String birthDate; // 出生日期
final String address; // 住址
final String idNumber; // 身份证号码/永久居留证号码
final String signOrgan; // 签发机关
final String beginTerm; // 有效期起始日期
final String validTerm; // 有效期截止日期
final String version; // 证件版本号
final String? photoBase64; // 头像JPG照片base64编码
final String? fingerprintBase64; // 指纹特征值base64编码
final List<int>? photo; // 照片数据(原始格式)
IdCardInfo({
required this.cardType,
required this.name,
this.nameEn = '',
required this.gender,
this.genderId = '',
required this.nation,
this.nationId = '',
required this.birthDate,
required this.address,
required this.idNumber,
required this.signOrgan,
this.beginTerm = '',
required this.validTerm,
this.version = '',
this.photoBase64,
this.fingerprintBase64,
this.photo,
});
/// 从Map创建IdCardInfo对象
factory IdCardInfo.fromMap(Map<String, dynamic> map) {
return IdCardInfo(
cardType: map['cardType'] ?? '',
name: map['name'] ?? '',
nameEn: map['nameEn'] ?? '',
gender: map['gender'] ?? '',
genderId: map['genderId'] ?? '',
nation: map['nation'] ?? '',
nationId: map['nationId'] ?? '',
birthDate: map['birthDate'] ?? '',
address: map['address'] ?? '',
idNumber: map['idNumber'] ?? '',
signOrgan: map['signOrgan'] ?? '',
beginTerm: map['beginTerm'] ?? '',
validTerm: map['validTerm'] ?? '',
version: map['version'] ?? '',
photoBase64: map['photoBase64'],
fingerprintBase64: map['fingerprintBase64'],
photo: map['photo'] != null ? List<int>.from(map['photo']) : null,
);
}
/// 从冒号分隔的字符串创建IdCardInfo对象
/// 根据接口文档格式：证件类型:中文姓名:英文姓名:性别:性别代码:民族:民族代码:出生日期:住址:身份证号码:签发机关:发卡日期:卡有效期:证件版本号:头像JPG照片base64编码:指纹特征值base64编码
factory IdCardInfo.fromColonString(String colonString) {
final parts = colonString.split(':');
// 确保至少有16个部分
while (parts.length < 16) {
parts.add('');
}
return IdCardInfo(
cardType: parts[0],
name: parts[1],
nameEn: parts[2],
gender: parts[3],
genderId: parts[4],
nation: parts[5],
nationId: parts[6],
birthDate: parts[7],
address: parts[8],
idNumber: parts[9],
signOrgan: parts[10],
beginTerm: parts[11],
validTerm: parts[12],
version: parts[13],
photoBase64: parts[14].isNotEmpty ? parts[14] : null,
fingerprintBase64: parts[15].isNotEmpty ? parts[15] : null,
);
}
/// 转换为Map
Map<String, dynamic> toMap() {
return {
'cardType': cardType,
'name': name,
'nameEn': nameEn,
'gender': gender,
'genderId': genderId,
'nation': nation,
'nationId': nationId,
'birthDate': birthDate,
'address': address,
'idNumber': idNumber,
'signOrgan': signOrgan,
'beginTerm': beginTerm,
'validTerm': validTerm,
'version': version,
'photoBase64': photoBase64,
'fingerprintBase64': fingerprintBase64,
'photo': photo,
};
}
@override
String toString() {
return 'IdCardInfo{cardType: $cardType, name: $name, nameEn: $nameEn, gender: $gender, genderId: $genderId, nation: $nation, nationId: $nationId, birthDate: $birthDate, address: $address, idNumber: $idNumber, signOrgan: $signOrgan, beginTerm: $beginTerm, validTerm: $validTerm, version: $version}';
}
}
/// 身份证读卡器平台接口
abstract class IdcardPlatform extends PlatformInterface {
/// 构造函数
IdcardPlatform() : super(token: _token);
static final Object _token = Object();
static IdcardPlatform _instance = MethodChannelIdcard();
/// 默认实例
static IdcardPlatform get instance => _instance;
/// 设置平台特定的实现
static set instance(IdcardPlatform instance) {
PlatformInterface.verifyToken(instance, _token);
_instance = instance;
}
/// 获取平台版本
Future<String?> getPlatformVersion() {
throw UnimplementedError('platformVersion() has not been implemented.');
}
/// 获取USB权限
/// [vid] - USB设备的厂商ID
/// [pid] - USB设备的产品ID
Future<int> getUsbPermission(int vid, int pid) {
throw UnimplementedError('getUsbPermission() has not been implemented.');
}
/// 打开设备
/// [portType] - 端口类型，如"USB", "COM", "SKT", "BTH", "AUTO"
/// [portPara] - 端口参数
/// [extendPara] - 扩展参数
/// 返回值：大于0表示成功（设备句柄），其他为失败
Future<int> openDevice({String portType = 'USB', String portPara = '', String extendPara = ''}) {
throw UnimplementedError('openDevice() has not been implemented.');
}
/// 设置当前设备（多设备操作）
/// [devHandle] - 设备句柄
/// 返回值：0表示成功；非0表示失败
Future<int> setCurrentDevice(int devHandle) {
throw UnimplementedError('setCurrentDevice() has not been implemented.');
}
/// 获取当前设备（多设备操作）
/// 返回值：返回当前设备的句柄
Future<int> getCurrentDevice() {
throw UnimplementedError('getCurrentDevice() has not been implemented.');
}
/// 获取接口库信息
/// 返回值：包含version和description的Map
Future<Map<String, String>> getLibraryInfo() {
throw UnimplementedError('getLibraryInfo() has not been implemented.');
}
/// 获取设备型号
/// 返回值：设备型号字符串
Future<String> getTerminalModel() {
throw UnimplementedError('getTerminalModel() has not been implemented.');
}
/// 设备轮询心跳
/// 返回值：0表示成功；非0表示失败
Future<int> terminalHeartBeat() {
throw UnimplementedError('terminalHeartBeat() has not been implemented.');
}
/// 获取接收数据
/// 返回值：最后一次通讯收到的数据
Future<List<int>> getLastRecvData() {
throw UnimplementedError('getLastRecvData() has not been implemented.');
}
/// 获取设备固件版本
/// 返回值：包含firmVersion和hardwareVersion的Map
Future<Map<String, String>> getTerminalFirmVersion() {
throw UnimplementedError('getTerminalFirmVersion() has not been implemented.');
}
/// 获取设备序列号
/// 返回值：设备序列号字符串
Future<String> getTerminalSn() {
throw UnimplementedError('getTerminalSn() has not been implemented.');
}
/// 关闭设备
/// 返回值：0表示成功；非0表示失败
Future<int> closeDevice() {
throw UnimplementedError('closeDevice() has not been implemented.');
}
/// 寻卡
Future<int> findCard() {
throw UnimplementedError('findCard() has not been implemented.');
}
/// 选卡
Future<int> selectCard() {
throw UnimplementedError('selectCard() has not been implemented.');
}
/// 读取身份证（新版接口，支持多种证件类型）
/// [cardType] - 读取卡类型：
/// 0x00：读取二代证或外国人或港澳台
/// 0x01：只读二代证
/// 0x02：只读外国人
/// 0x03：只读港澳台
/// 0x10-0x13：对应上述类型但包含指纹信息
/// [infoEncoding] - 返回信息的编码方式：
/// 0x01：GB18030编码（GBK）
/// 0x02：UTF16-LE编码
/// 0x03：UTF-8编码
/// [timeOut] - 读卡超时时间（毫秒），0表示不等待，>0表示等待放卡
/// 返回值：0表示成功；非0表示失败，成功时返回冒号分隔的身份证信息字符串
Future<Map<String, dynamic>> idReadCard({int cardType = 0x00, int infoEncoding = 0x01, int timeOut = 30000}) {
throw UnimplementedError('idReadCard() has not been implemented.');
}
/// 读取身份证（兼容旧版接口）
/// [cardType] - 卡片类型
/// [infoEncoding] - 信息编码
/// [timeOut] - 超时时间（毫秒）
Future<Map<String, dynamic>> readCard({int cardType = 1, int infoEncoding = 0, int timeOut = 30000}) {
throw UnimplementedError('readCard() has not been implemented.');
}
/// 读取身份证详细信息
Future<IdCardInfo> readCardInfo() {
throw UnimplementedError('readCardInfo() has not been implemented.');
}
/// 读取追加住址
/// 返回值：追加住址信息字符串
Future<String> readNewAddress() {
throw UnimplementedError('readNewAddress() has not been implemented.');
}
/// 获取SAM模块状态
/// 返回值：0表示成功；非0表示失败
Future<int> getSamStatus() {
throw UnimplementedError('getSamStatus() has not been implemented.');
}
/// 获取SAM模块编号字符串
/// 返回值：SAM模块编号字符串
Future<String> getSamIdStr() {
throw UnimplementedError('getSamIdStr() has not been implemented.');
}
}