2016年中国联通数字化营业厅一体化高拍仪接口规范v1.0

2016年中国联通总部数字化营业厅一体化高拍仪设备接口规范文件状态： 草稿 正式发布 正在修改当前版本：1.0作 者：狄秋燕，朱雯莉，胡迪，孟莉莉制作单位中国联通信息化部完成日期：2016-7-28审 核：目录一、更新历史3二、外设设备接口要求32.1.电子凭证采集功能模块接口要求32.1.1.功能说明42.1.2.动态链接库名称42.1.3.调用过程52.1.4.函数说明63.1.二代身份证阅读及读写卡功能模块网页OCX控件规范103.1.1.控件引入103.1.2.控件方法113.1.3.控件属性133.1.4.软件安装143.1.5.基准测试网页14一、更新历史2016.7.28 V1.0 初次编写二、外设设备接口要求1.2.2.1. 电子凭证采集功能模块接口要求电子凭证采集功能模块，对接联通无纸化系统，外设接口类型为Windows DLL,接口调用方式采用stdcall标准调用，每个厂家的每类设备只能提供一个DLL文件。设备命名为设备类型.dll。驱动文件存放地址对于windows系统，为安装操作系统所在盘的WINDOWSsystem32目录下。在打开相关设备时，当输入参数端口号为-1时，驱动文件按照本地配置文件中设备对应的端口号调用相关设备，其它数值按照输入参数调用相应端口设备。各驱动的命名如下：驱动命名列表设备类型描述设备命名电子扫描设备Unicom_Cap.dll设备本地配置文件说明：本地配置文件用来配置驱动日志地址信息。配置信息的windows存放在地址C:DeviceDriverConf.ini中。1.驱动文件日志记录要求：WriteLog（WriteLog值为0：不记录日志；WriteLog值为1，不记录调用接口函数的参数；WriteLog值为2，记录调用接口函数的参数）2.配置文件格式为：Unicom_SignUserIdCardPort=6 （设备端口）WriteLog=1UserIdCardAddress=C: DeviceDriverLog signUnicom_CapUserIdCardPort=7 （设备端口）WriteLog=1MutiIdCardAddress=C: DeviceDriverLog cap3.状态码常量定义状态码（正常状态、运行状态、告警状态）建议用8位数字或字母表示。第1位表示状态类型，1：正常状态 2：运行信息 3：维护告警（级别：黄维护） 4：故障告警（红维修）。第2-6位表示设备类型码。第7-8位表示各部件的状态类型。2.1.1. 功能说明对此接口进行定义、作用、参数、描述等定义电子凭证采集设备相关的打开、关闭、采集（为保证图像质量可选预览模式）、连接状态查询、裁剪旋转等基本操作接口与操作流程与错误码等信息表示方式。2.1.2. 动态链接库名称设备厂家提供的主动态库名称为Unicom_Cap.dll，由设备厂商根据该DLL开发相应OCX插件。OCX插件与动态库之间的调用流程如图所示。设备厂商负责画面质量以及云终端兼容性。 图3-1 OCX插件与动态库之间的调用流程图2.1.3. 调用过程定义此接口所输出的参数、格式、大小等进行说明接口参数、函数格式等详见下一节。各操作过程解释如下：操作名功能定义备注打开设备通过上位机程序为设备分配必要的系统资源关闭设备释放设备所占用的系统资源获得设备信息返回设备PID、VID、唯一ID、厂商名称、设备型号、支持分辨率等信息获得设备状态调用设备自检程序，返回设备可用状态采集影像操作（主摄像头）采集资料影像图片，返回图片存储位置(支持自动裁剪与手动裁剪模式)采集影像操作（辅摄像头）采集客户影像图片，返回图片存储位置预览视频（主摄像头）在指定窗口上显示资料影像(支持自动和手动绘图)预览视频（辅摄像头）在指定窗口上显示客户影像照片旋转旋转照片类型码定义操作指令所返回的各种状态码定义2.1.4. 函数说明2.1.4.1. 打开设备打开电子凭证采集设备识读函数函数描述打开设备函数名int_stdcall OpenDevice(int Port,char* retMsg)属性变量名称类型变量含义备 注入口参数Portint端口号USB端口从1000开始。USB1填1001，驱动自己处理Baud 波特率DataBits 数据位StopBits 停止位Parity 奇偶校验自行在驱动里处理出口参数retMsgchar *错误信息执行失败时返回的错误信息，最大60字节返回值int0>Success；状态码> Fail附加说明2.1.4.2. 关闭设备关闭电子凭证采集设备识读函数函数描述关闭设备函数名int_stdcall CloseDevice(char* retMsg)属性变量名称类型变量含义备 注出口参数retMsgchar *错误信息执行失败时返回的错误信息，最大60字节返回值int0àSuccess；状态码à Fail附加说明2.1.4.3. 获得设备信息获取电子凭证采集设备信息函数函数描述获得设备信息函数名typedef structchar pid60; /设备PIDchar uuid60; /唯一编号char vid60; /设备VIDchar56 VendorName厂家名称char32 ProductName设备型号char version60; /DLL版本号char res256; /支持分辨率字符串，如”1920X1080,1366X768,640X480”DeviceInfo;int _stdcall getDeviceInfo(DeviceInfo *info, char* retMsg);属性变量名称类型变量含义备 注入口参数infoDeviceInfo设备信息返回设备信息出口参数retMsgchar*执行结果中文解释最大长度：60返回值retCodeint执行结果状态码0à Success；非0àretMsg解释2.1.4.4. 获得设备状态获取电子凭证采集设备状态函数函数描述获得设备状态函数名int _stdcall getDeviceStatus(int* code ，char* retMsg);属性变量名称类型变量含义备 注返回值retCodeint执行结果状态码0à Success；非0à函数执行失败出口参数codeint*状态code出口参数retMsgchar*执行结果中文解释最大长度：60附加说明主要查看设备是否连接，不处于正在被使用状态，并可正常调用读取函数。附加说明2出口参数对应设备状态：2.1.4.5. 预览视频(主摄像头)预览视频（主摄像头）函数函数描述预览视频函数名int _stdcall previewDeviceA(void* displayHandle, int type,int Angle, char* Resolution, char * retMsg)属性变量名称类型变量含义备 注返回值retCodeint执行结果状态码0à Success；非0àretMsg解释入口参数displayHandlevoid*视频显示控件句柄Windows控件句柄入口参数typeint证件类型见附件说明，主要用于根据类型提示裁剪区域入口参数Angleint旋转角度主要用于视频预览时旋转只能为0，90，180，270入口参数Resolutiounchar*分辨率主要用于视频预览时的分辨率，为空时自行定义出口参数retMsgchar*执行结果中文解释最大长度：60附加说明主要预览资料影像。附加说明2所有凭证类型代码遵循以下解释：0：未定义（手动裁切）1：二代身份证2: 临时身份证3：户口本4：中国护照5：国际护照6：军官证（士兵证）7：港澳通行证8：港澳居民往来内地通行证9：台湾居民来往大陆通行证10：二代证背面2.1.4.6. 预览视频(辅摄像头)预览视频（辅摄像头）函数函数描述预览视频函数名int _stdcall previewDeviceB(void* displayHandle, char * retMsg)属性变量名称类型变量含义备 注返回值retCodeint执行结果状态码0à Success；非0àretMsg解释入口参数displayHandlevoid*视频显示控件句柄Windows控件句柄出口参数retMsgchar*执行结果中文解释最大长度：60附加说明主要预览客户影像。附加说明2返回值对应设备状态2.1.4.7. 采集影像操作（主摄像头）电子凭证采集设备采集函数函数描述采集影像操作函数名int _stdcall photographA(char* retFileName, char * retMsg)属性变量名称类型变量含义备 注入口参数retFileNamechar *图像保存文件名称（全路径的）最大长度：256出口参数retMsgchar*执行结果中文解释最大长度：60返回值retCodeint执行结果状态码0à Success；非0àretMsg解释附加说明所有凭证类型代码遵循以下解释：0：未定义1：二代身份证2: 临时身份证3：户口本4：中国护照5：国际护照6：军官证（士兵证）7：港澳通行证8：港澳居民往来内地通行证9：台湾居民来往大陆通行证10：二代证背面2.1.4.8. 采集影像操作（辅摄像头）电子凭证采集设备采集函数函数描述采集影像操作函数名int _stdcall photographB(char* retFileName, int type, char * retMsg)属性变量名称类型变量含义备 注入口参数typeint凭证类型取值见附件说明入口参数retFileNamechar *图像保存文件名称（全路径的）最大长度：128出口参数retMsgchar