FS562开发手册范本.doc

《FS562开发手册范本.doc》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、证件扫描、识别、读卡SDK开发手册目录第一章SDK简介21.1SDK运行环境21.2SDK主要功能描述21.3调用约束21.4SDK文件清单：21.5SDK使用流程简述3第二章设备的安装和使用42.1设备的安装42.2设备的使用4第三章接口调用63.1接口参数中用到结构的定义：63.2接口函数返回值列表103.3扫描、识别、读卡接口说明：113.3调用流程简图：163.4示例程序简介17第一章SDK简介1.1SDK运行环境本SDK可在以下操作系统中调用：MicrosoftWindowsNt4.0、MicrosoftWindows98、MicrosoftWindows2000、Mi

2、crosoftWindowsXP。使用本SDK要求计算机不得低于以下配置：PIII800Mhz(CPU)、128M（存）。1.2SDK主要功能描述本SDK主要实现了以下几项功能：1)驱动设备录入仪进行扫描，得到各种件图像文件（包括一代、二代、护照等）。2)根据用户的需求对一代、二代、护照、港澳往来大陆的通行证、台胞证图像中的相关字段信息部分进行识别，并将识别结果根据用户的要求保存到一个txt文本中。3)根据用户的需求可以将一代、二代、护照、港澳往来大陆的通行证、台胞证图像中的证件头像提取出来，保存到指定的图像文件中。4)驱动设备读卡器读取二代中的居民个人身份信息和头像。1.3调用

3、约束在调用扫描、识别、读卡SDK前，请确保设备设备已正确安装，并正常连接。这也就是说，本SDK只有在挂接设备设备后才能正常调用，否则将加载失败无法调用。1.4SDK文件清单：DEMO文件夹：设备功能演示程序。Driver文件夹：设备驱动。DLL-Data文件夹：设备扫描、识别、读卡SDK核心文件（Drv_CardAll.dll）。Document文件夹：设备扫描、识别、读卡SDK开发手册。Samples文件夹：SDK的C++，语言调用例程。LIB-H文件夹：设备扫描、识别、读卡SDK核心文件和头文件。1.1SDK使用流程简述一般说来，使用SDK的大致流程如下：安装设备进行扫描识别

4、或读卡卸载扫描、识别、读卡SDK库加载扫描、识别、读卡SDK库Drv_CardAll.dllDrv_CardAll.dllDrv_CardAll.dll第二章设备的安装和使用2.1设备的安装本SDK采用设备加密，故使用SDK核心时必须首先正确连接设备设备，并根据系统提示安装好相应的驱动程序。当把设备FS562插接到PC机的USB口上后，操作系统会提示“发现新的硬件设备”并要求安装该设备的驱动程序，这时请指定设备驱动程序所在路径即可完成设备的安装。2.2设备的使用（1）要使用设备的所有功能，需要生成License文件，方法如下：一、运行注册文件生成器程序二、将设备使用手册首页上的序

5、列号填写到程序界面，将生成的VerifyPsw.dat放到Drv_CardAll.dll所在目录下即可（2）设备录入仪的校准：使用设备时，如果扫描得到的图像质量下降，用户需要校准设备录入仪，以提高扫描图像的质量。如果校准后扫描质量仍不是太好(如有纵向条纹等)，这时可以通过扫描图像工具或SDK中的演示程序再进行重复校准（也可以调用SDK中的校准函数实现）。具体方法如下：如果采用扫描工具进行校准，只需点击twain界面上的校准按钮即可（如下图）；如果采用演示程序校准，只需点击演示界面上的“校准录入仪”按键；如果是采用SDK核心的接口来校准，可以参考后面的接口调用流程来实现。（2）件的

6、扫描：在通过SDK核心扫描、识别各种件图像时，件应该顶住扫描玻璃平板的左上角，这样才能保证扫描得到的图像能够满足后序识别的要求（如下图）。对于一、二代,将件的宽边和扫描玻璃平板的左边贴紧，而护照进行扫描识别时，将护照展开，放置在扫描玻璃平板上。录入仪上的四个按键（其中A和D键功能相同）可以通过SDK核心中的接口来分别定义和控制，具体使用方法见后面接口说明部分。第三章接口调用本章我们将扫描、识别、读卡等接口进行阐述。由于实际所使用到的编程语言很多，我们不可能一一涉及到。我们在此只将C++语言对接口如何进行调用进行讲解。其它语言如何进行调用，用户可参照接口调用例程。3.1接口参数中用

7、到结构的定义：(1)件全部识别结果导出结构（包括签发日期和有效期）typedefstruct{charname[40];//charSurnameCH[100];//中文姓charnameCH[100];//中文名charsex[10];//性别charGender[10];//性别（英文）charbirthday[50];//出生日期charpeople[20];//民族charsigndate[50];//发证日期charvalidterm[50];//有效期限charadd