文档介绍：证件扫描、识别、读卡SDK
开发手册
目录
第一章 SDK简介 2
SDK运行环境 2
SDK主要功能描述 2
调用约束 2
SDK文件清单: 2
SDK使用流程简述 3
第二章设备的安装和使用 4
设备的安装 4
设备的使用 4
第三章接口调用 6
: 6
接口函数返回值列表 10
扫描、识别、读卡接口说明: 11
: 16
示例程序简介 17
第一章 SDK简介
SDK运行环境
本SDK可在以下操作系统中调用:Microsoft Windows 、Microsoft Windows98、Microsoft Windows2000、Microsoft WindowsXP。
使用本SDK要求计算机不得低于以下配置:PIII800 Mhz(CPU)、128M(内存)。
SDK主要功能描述
本SDK主要实现了以下几项功能:
1) 驱动设备录入仪进行扫描,得到各种身份证件图像文件(包括一代身份证、二代身份证、护照等)。
2) 根据用户的需求对一代身份证、二代身份证、护照、港澳往来大陆的通行证、台胞证图像中的相关字段信息部分进行识别,并将识别结果根据用户的要求保存到一个txt文本中。
3) 根据用户的需求可以将一代身份证、二代身份证、护照、港澳往来大陆的通行证、台胞证图像中的证件头像提取出来,保存到指定的图像文件中。
4) 驱动设备读卡器读取二代身份证中的居民个人身份信息和头像。
调用约束
在调用身份证扫描、识别、读卡SDK前,请确保设备设备已正确安装,并正常连接。这也就是说,本SDK只有在挂接设备设备后才能正常调用,否则将加载失败无法调用。
SDK文件清单:
DEMO 文件夹:设备功能演示程序。
Driver 文件夹:设备驱动。
DLL-Data文件夹:设备扫描、识别、读卡SDK核心文件()。
Document文件夹:设备扫描、识别、读卡SDK开发手册。
Samples 文件夹: SDK的C++,语言调用例程。
LIB-H文件夹:设备扫描、识别、读卡SDK核心链接文件和头文件。
SDK使用流程简述
一般说来,使用SDK的大致流程如下:
安装设备
进行扫描识别或读卡
卸载扫描、识别、读卡SDK库
加载扫描、识别、
第二章设备的安装和使用
设备的安装
本SDK采用设备加密,故使用SDK核心时必须首先正确连接设备设备,并根据系统提示安装好相应的驱动程序。
当把设备FS562插接到PC机的USB口上后,操作系统会提示“发现新的硬件设备”并要求安装该设备的驱动程序,这时请指定设备驱动程序所在路径即可完成设备的安装。
设备的使用
要使用设备的所有功能,需要生成License文件,方法如下:
一、运行注册文件生成器程序
二、将设备使用手册首页上的序列号填写到程序界面,
设备录入仪的校准: 使用设备时,如果扫描得到的图像质量下降,用户需要校准设备录入仪,以提高扫描图像的质量。如果校准后扫描质量仍不是太好(如有纵向条纹等),这时可以通过扫描图像工具或SDK中的演示程序再进行重复校准(也可以调用SDK中的校准函数实现)。具体方法如下:如果采用扫描工具进行校准,只需点击twain界面上的校准按钮即可(如下图);如果采用演示程序校准,只需点击演示界面上的
“校准录入仪”按键;如果是采用SDK核心的接口来校准,可以参考后面的接口调用流程来实现。
(2)身份证件的扫描:在通过SDK核心扫描、识别各种身份证件图像时,身份证件应该顶住扫描玻璃平板的左上角,这样才能保证扫描得到的图像能够满足后序识别的要求(如下图)。对于一、二代身份证,将身份证件的宽边和扫描玻璃平板的左边贴紧,而护照进行扫描识别时,将护照展开,放置在扫描玻璃平板上。录入仪上的四个按键(其中A和D键功能相同)可以通过SDK核心中的接口来分别定义和控制,具体使用方法见后面接口说明部分。
第三章接口调用
本章我们将扫描、识别、读卡等接口进行阐述。由于实际所使用到的编程语言很多,我们不可能一一涉及到。我们在此只将C++语言对接口如何进行调用进行讲解。其它语言如何进行调用,用户可参照接口调用例程。
:
(1)身份证件全部识别结果导出结构(包括签发日期和有效期)
typedef struct
{
char name