智能终端接口规
版本号1.0
三元达软件有限公司
二O—四年六月
文档变更说明
目录
1.前言 (4)
2.目的围 (5)
3.原则 (5)
4.术语及缩略语 (5)
5.写卡器设备功能域接口 (6)
5.1组件名称 (6)
5.2函数说明 (6)
5.3调用过程 (14)
6.二代证身份识别设备功能域接口 (14)
6.1组件名称 (14)
6.2函数说明................................................................ 1 5
6.3调用过程 (18)
7.写卡器设备功能域接口 (18)
7.1组件名称 (18)
7.2函数说明................................................................ 1 9
7.3调用过程 (23)
8.银行卡读卡器设备功能域接口 (24)
8.1组件名称 (24)
8.2函数说明 (24)
8.3调用过程 (28)
9.一体机组件名称 (28)
10.一体机接口规 (29)
1)一体机二代证读卡 (29)
2)一体机SIM卡读写卡 (29)
3)一体机打印机 (29)
丄、八
1.前言
近几年，随着An droid 、iOS等智能终端操作系统的推广，智能终端功能越来越丰富，越来越被大众所接受，移动互联网正欣欣向荣。
智能终端具有体积小、携带方便、移动办公等优势。
移动顺应时代潮流，利用移动互联网新技术，采取更为积极主动的营销和服务模式，也建立了包括智能终端版CRM 等移动应用，完善了自身的运营支撑能力，以适应市场的需要，提升了自身竞争力，保持自身的行业优势。
移动智能终端应用在业务办理过程中，使用到了多种多样的外接设备辅助办公，如蓝牙打印机、蓝牙二代证读卡器、蓝牙SIM信息读卡器等，为企业办公、客户带来的极大的方便。
与此同时也带来了问题，同种设备不同厂商在实现方式上各有差别，要兼容不同的外设厂商就必须付出等量的劳动力。
因此建立一套智能终端外设接口规刻不容缓。
智能终端外设接口规明确了外设接入移动智能终端应用的技术规、业务功能，以指导各外设厂家如何根据规接入移动智能终端应用。
2.目的围
智能终端外设接口规适用于指导各外设厂家将其外设按照规合理、高效、快速地接入移动智能终端应用，是各外设厂家接入移动智能终端应用的主要依据。
本规规定了外设的技术规、业务功能，操作流程。
3.原则
本规尽可能依据现有外设的行业技术规，并能尽量最大化兼容各外设厂商
4.术语及缩略语
下列术语和缩略语适用于本规：
是一种以Linux 为基础的开放源码操作系统，主要使用于便携设备。
Android
是由苹果公司开发的手持设备操作系统。
iOS与苹果的Mac OS X操
iOS iOS
作系统一样，它也是以Darwin为基础的，因此同样属于类Unix的商业
操作系统。
客户是指一个正在使用及可能使用移动（包括第三方合作伙伴）提供的产品和服务的个人、企业或者其他团体。
蓝牙
是一种支持设备短距离通信（一般10m ）的无线电技术。
能在包括移动、
PDA 、无线耳机、笔记本电脑、相关外设等众多设备之间进行无线信息交换。
用户用户是移动客户订购产品的实例。
包括资源占用、用户价值、订购信息。
智能终端是指像个人电脑一样，具有独立的操作系统，可以由用户自行安装软件、游戏等第三方服务商提供的程序，通过此类程序来不断对终端的功能进
行扩充，并可以通过移动通讯网络来实现无线网络接入的这样一类终端的总
称。
二代证第二代居民身份证
CRM 客户关系管理(Customer Relationship Management)
SIM 用户识别卡( Subscriber Identity Module )
5.写卡器设备功能域接口
5.1组件名称
CMCC_PRINT_厂家英文名缩写—厂家设备型号缩写.so 5.2函数说明
1）连接打印机
2）关闭打印机
3）获取组件版本信息
4）初始化打印机
方法描述
5）设置字体宽高缩放比例
6）设置对齐方式
7）设置左边距
8）设置右边距
9）设置行间距
10）设置字符间距
11）设置打印方向
12）设置/取消粗体打印
13）设置/取消下划线打印
14）设置/取消反白打印
15）打印字符串
佝打印HTML格式数据
5.3调用过程
智能终端版CRM客户端热敏打印机
图1
打印流程
1、加载组件，调用加载外设组件流程。
2、建立与热敏打印机的连接。
3、调用组件的初始化打印机方法。
4、调用组件的设置打印机参数方法集，如设置对齐方式、设置行间距等方法。
5、调用组件的打印字符或打印HTML格式数据方法。
6、打印机打印票据。
7、关闭连接。
6.二代证身份识别设备功能域接口
6.1组件名称
CMCC_IDCARD_ 厂家英文名缩写—厂家设备型号缩写.so
4.调用组件：设置打印参数集函数
5.调用组件：打印函数
7.调用组件：关闭连接
3.调用组件：初始化打印机函数
6.打印票据
6.2函数说明
1）连接二代证身份识别设备
2）关闭二代证身份识别设备
3）获取组件版本信息
4）初始化二代证身份识别设备
5）获得二代证信息
6.3调用过程
2.
3.调用组件：初始化
4.调用组件：获取二代身份证信息
5.显示二代身份证信息
k ----
6.调用组件：关闭连接
图2
二代证身份识别流程图示
1、加载组件，调用加载外设组件流程。
2、建立与二代证身份识别设备的连接。
3、调用组件的初始化二代证身份识别设备方法。
4、调用组件的获取二代证信息方法。
5、页面显示二代证身份信息。
6、关闭连接。
7.写卡器设备功能域接口
7.1组件名称
CMCC_SIMCARD_ 厂家英文名缩写—厂家设备型号缩写.so
7.2函数说明1）获取版本信息
2）读空卡序列号
3)读取卡片信息
4)实时写卡数据写入
5)获取错误信息
6）获取读卡器信息
4.ReaderType 为 4 时取
值如下：可以设置为固定
值，也可以不配置
入口参数Password char[] 蓝牙读卡器连
接密码
蓝牙读卡器连接密码，该字
段为预留字段。
返回值int 0 —>Success ;
非0状态码—> Fail
附加说明无
7.3调用过程
、土H 读卡
智能终端版CRM客户端写卡器_
图3
读卡流程图
1、加载组件，调用加载外设组件流程。
2、通过外设组件相关函数调用统一写卡组件各函数进行读卡
3、显示读卡结果。
4.调用外设组件读卡
3.加载统一写卡组件
5.返回读卡结果
智能终端版CRM客户端写卡器
1.加载外设组
件
1.加载读卡器控制组件
2.加载统一写卡组件
3.调用外设组件写卡
4.返回写卡结果
图4
写卡流程图
1、加载组件，调用加载外设组件流程。
2、通过外设组件相关函数调用统一写卡组件各函数进行写卡，具体步骤请参见《中国移
动现场写卡技术规2.0》。
3、显示写卡结果。
8•银行卡读卡器设备功能域接口
8.1组件名称
CMCC_BANKCARD_ 厂家英文名缩写—厂家设备型号缩写.so
8.2函数说明
1）连接银行卡读卡器设备
方法描述连接银行卡读卡器设备
包名+类名.cmcc .n ativepackage.Ba nkCard
2）关闭银行卡读卡器设备
3）获取组件版本信息
4）初始化银行卡读卡器
5）获得银行卡信息
8.3调用过程
5.显示银行卡信息 ；
r -"1
6.调用组件：关闭连接
I
图5
银行卡读卡流程图示
1、 加载组件，调用加载外设组件流程。
2、 建立与银行卡读卡器设备的连接。
3、
调用组件的初始化银行卡读卡器方
法。
4、 调用组件的获取银行卡信息方法。
5、 页面显示银行卡信息。
6、 关闭连接。
智能终端版CRM 客户端 银行卡读卡器
1.加载组件
2.调用组件：建立连接
3.调用组件：初始化
4.调用组件：获取银行卡信息
9. 一体机组件名称
CMCC_UNITDEVICE_厂家英文名缩写—厂家设备型号缩写.so
10. 一体机接口规
1)一体机二代证读卡
请参见本文档7~9规
2)一体机SIM卡读写卡
请参见本文档10~12规
3)一体机打印机
请参见本文档4~6规
Word文档资料。