中国联通数字化营业厅一体化高拍仪接口规范v

2016年中国联通总部数字化营业厅一体化高拍仪设备接口规范
目录
一、更新历史
初次编写
二、外设设备接口要求
2.1.电子凭证采集功能模块接口要求
电子凭证采集功能模块，对接联通无纸化系统，外设接口类型为Windows DLL,接口调用方式采用stdcall标准调用，每个厂家的每类设备只能提供一个DLL文件。

设备命名为设备类型.dll。

驱动文件存放地址对于windows系统，为安装操作系统所在盘的WINDOWS\system32目录下。

在打开相关设备时，当输入参数端口号为-1时，驱动文件按照本地配置文件中设备对应的端口号调用相关设备，其它数值按照输入参数调用相应端口设备。

各驱动的命名如下：
驱动命名列表
设备类型描述设备命名
电子扫描设备
设备本地配置文件说明：本地配置文件用来配置驱动日志地址信息。

配置信息的windows存放在地址C:\中。

1. 驱动文件日志记录要求：
WriteLog（WriteLog值为0：不记录日志；WriteLog值为1，不记录调用接口函数的参数；WriteLog值为2，记录调用接口函数的参数）
2. 配置文件格式为：
[Unicom_Sign]
UserIdCardPort=6 （设备端口）
WriteLog=1
UserIdCardAddress=C: \DeviceDriverLog\ sign\
[Unicom_Cap]
UserIdCardPort=7 （设备端口）
WriteLog=1
MutiIdCardAddress=C: \DeviceDriverLog\ cap\
3. 状态码常量定义
状态码（正常状态、运行状态、告警状态）建议用8位数字或字母表示。

第1位表示状态类型，
1：正常状态
2：运行信息
3：维护告警（级别：黄维护）
4：故障告警（红维修）。

第2-6位表示设备类型码。

第7-8位表示各部件的状态类型。

2.1.1.功能说明
对此接口进行定义、作用、参数、描述等
定义电子凭证采集设备相关的打开、关闭、采集（为保证图像质量可选预览模式）、连接状态查询、裁剪旋转等基本操作接口与操作流程与错误码等信息表示方式。

2.1.2.动态链接库名称
设备厂家提供的主动态库名称为，由设备厂商根据该DLL开发相应OCX 插件。

OCX插件与动态库之间的调用流程如图所示。

设备厂商负责画面质量以及云终端兼容性。

图3-1 OCX插件与动态库之间的调用流程图
2.1.
3.调用过程
定义此接口所输出的参数、格式、大小等进行说明
接口参数、函数格式等详见下一节。

各操作过程解释如下：
2.1.4.函数说明
2.1.4.1.打开设备
打开电子凭证采集设备识读函数
2.1.4.2.关闭设备
关闭电子凭证采集设备识读函数
2.1.4.
3.获得设备信息获取电子凭证采集设备信息函数
ListReaderCard();
1.ReadCard方法
var strReadResult=();
if (strReadResult=="0"){
DisconnectCard (str);
2.1.1.软件安装
要求厂商提供安装软件，该安装软件具备如下功能：
驱动和控件等安装所需文件需打包在一个安装程序中，免驱动的设备需提供控件的安装程序。

驱动默认安装目录C:\ IDCardReader。

安装浏览器的OCX控件及相关所依赖的文件，需符合本文档对OCX控件的要求。

驱动程序和OCX控件需支持WindowsXP，WIN7（包括32位和64位）。

浏览器需支持IE6,IE7,IE8以及360。

安装程序启动运行后能实现自动识别操作系统版本和浏览器版本而进行相应的安装，安装过程信息明确，尽量减少人工交互，并自动注册OCX 控件。

对于已经安装过时版本控件的系统，要能保证读卡器软件安装后，新控件可以覆盖原控件并生效。

2.1.2.基准测试网页
各厂家要保证基于如上操作系统和浏览器在基准测试网页上能测试通过，并保证不弹出安全提示对话框，说明插件符合规范要求。