文档介绍：
文档编号:ZGWT-QR-IDCARD-05
文档版本:
起草部门:软件开发部行业组
起草时间: 2010年5月
第一章 SDK简介 3
SDK版权说明 3
SDK运行环境 3
SDK主要功能描述 3
调用约束 3
SDK文件清单: 4
SDK使用流程简述 4
第二章接口调用 5
5
扫描识别接口说明 6
6
7
10
12
14
16
17
18
20
22
23
24
26
: 28
示例程序简介 29
第三章注意事项 29
29
29
,结果不对 29
技术支持 30
第一章 SDK简介
SDK版权说明
身份证扫描识别SDK版权归属北京文通科技有限公司所有,未经北京文通科技有限公司授权,不得擅自进行使用。
SDK运行环境
本SDK可在以下操作系统中调用:Microsoft Windows98、Microsoft Windows 2000、Microsoft Windows XP、Microsoft Windows Server 2003 。
使用本SDK要求计算机不得低于以下配置:PIII(CPU)、128M(内存)。
SDK主要功能描述
本SDK主要实现了以下几项功能:
1) 驱动专用扫描仪(如AVA5、AVA6、D300+,D800Ⅱ等)或拍照设备(如CR620)采集各种身份证件彩色图像文件(包括一代身份证、二代身份证,二代身份证背面,驾照、护照、军官证、回乡证、港澳通行证,行驶证等);
2) 根据用户的需求对各种身份证件图像中相关字段信息部分进行版面分析、字符切分和字符识别,并可以将识别结果根据用户的要求保存到一个txt文本文件中;
3) 根据用户的需求可以将身份证图像中用户的头像提取出来,保存到指定的图像文件中。
4)如选用的是专用的拍照设备(如CR620),则红外图像和彩色图像保存在同一目录下,SDK接口中imgfile_name是彩色图像的完整路径名,而红外的是自动生成,比如imgfile_name=c:\\我的图片\\,红外的图像将自动名为c:\\我的图片\\ 。
5)如选用的是拍照设备(如CR620),则一代证可以选用红外识别,或可见光识别,或两者都识别,(配置文件内有说明)。
调用约束
在调用身份证识别SDK前,请确保选用的身份证专用扫描仪或拍照设备已正确安装完毕,并正常连接。这也就是说,本身份证识别SDK只有在挂接身份证专用扫描仪或拍照设备后才能正常调用,否则将加载失败无法调用。
SDK文件清单:
Driver 文件夹:扫描仪驱动。
DLL&LIB文件夹:识别核心文件。
HelpDoc 文件夹:识别核心的开发手册。
Samples 文件夹: SDK的调用例程,包括VB、VC、C#的。
SDK使用流程简述
一般说来,使用SDK的大致流程如下:
安装扫描仪\拍照设备
循环进行识别
卸载识别SDK库
加载识别SDK库
第二章接口调用
本章将身份证识别SDK等接口进行阐述。由于实际所使用到的编程语言很多,不可能一一涉及到。在此只将C++语言对接口如何进行调用进行讲解。其它语言如何进行调用,用户可参照接口调用例程。
身份证识别结果导出结构(包括签发日期和有效期)
typedef struct
{
char name[40]; //姓名
char sex[10]; //性别
char people[20]; //民族,护照和港澳通行证识别时此项为空
char birthday[50]; //出生日期
char address[200]; //地址,在识别护照和港澳通行证时导出的//是国籍简码和机读码所有内容
//在识别军官证时为籍贯,部别,职务,衔//级,各字段之间以分号分隔
//识别二代证背面时导出签发机关
char signdate[50]; //签发日期,在识别护照和港澳通行证时导
//出的是有效期
//在识别军官证时为空
char vali