FS562开发手册.docVIP

证件扫描、识别、读卡SDK 开发手册 目录 第一章 SDK简介 2 1.1 SDK运行环境 2 1.2 SDK主要功能描述 2 1.3 调用约束 2 1.4 SDK文件清单： 2 1.5 SDK使用流程简述 3 第二章 设备的安装和使用 4 2.1 设备的安装 4 2.2 设备的使用 4 第三章 接口调用 6 3.1接口参数中用到结构的定义： 6 3.2 接口函数返回值列表 10 3.3 扫描、识别、读卡接口说明： 11 3.3调用流程简图： 16 3.4 示例程序简介 17 第一章 SDK简介 SDK运行环境 本SDK可在以下操作系统中调用：Microsoft Windows Nt4.0、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核心文件（Drv_CardAll.dll）。 Document文件夹：设备扫描、识别、读卡SDK开发手册。 Samples 文件夹： SDK的C++，语言调用例程。 LIB-H文件夹：设备扫描、识别、读卡SDK核心链接文件和头文件。 SDK使用流程简述 一般说来，使用SDK的大致流程如下： 第二章 设备的安装和使用 设备的安装 本SDK采用设备加密，故使用SDK核心时必须首先正确连接设备设备，并根据系统提示安装好相应的驱动程序。 当把设备FS562插接到PC机的USB口上后，操作系统会提示“发现新的硬件设备”并要求安装该设备的驱动程序，这时请指定设备驱动程序所在路径即可完成设备的安装。 设备的使用 要使用设备的所有功能，需要生成License文件，方法如下： 一、运行 注册文件生成器 程序 二、将设备使用手册首页上的序列号填写到程序界面，将生成的VerifyPsw.dat放到Drv_CardAll.dll所在目录下即可 设备录入仪的校准： 使用设备时，如果扫描得到的图像质量下降，用户需要校准设备录入仪，以提高扫描图像的质量。如果校准后扫描质量仍不是太好(如有纵向条纹等)，这时可以通过扫描图像工具或SDK中的演示程序再进行重复校准（也可以调用SDK中的校准函数实现）。具体方法如下：如果采用扫描工具进行校准，只需点击twain界面上的校准按钮即可（如下图）；如果采用演示程序校准，只需点击演示界面上的“校准录入仪”按键；如果是采用SDK核心的接口来校准，可以参考后面的接口调用流程来实现 。 （2）身份证件的扫描：在通过SDK核心扫描、识别各种身份证件图像时，身份证件应该顶住扫描玻璃平板的左上角，这样才能保证扫描得到的图像能够满足后序识别的要求（如下图）。对于一、二代身份证,将身份证件的宽边和扫描玻璃平板的左边贴紧，而护照进行扫描识别时，将护照展开，放置在扫描玻璃平板上。录入仪上的四个按键（其中A和D键功能相同）可以通过SDK核心中的接口来分别定义和控制，具体使用方法见后面接口说明部分。 第三章 接口调用 本章我们将扫描、识别、读卡等接口进行阐述。由于实际所使用到的编程语言很多，我们不可能一一涉及到。我们在此只将C++语言对接口如何进行调用进行讲解。其它语言如何进行调用，用户可参照接口调用例程。 3.1接口参数中用到结构的定义： (1)身份证件全部识别结果导出结构（包括签发日期和有效期） typedef struct { char name [40]; //姓名 char SurnameCH[100]; //中文姓 char nameCH[100]; //中文名 char sex[10]; //性别 char Gender[10]; //性别（英文） char birthday[50];