一体化终端设备技术规范

智能终端接口规范

版本号 1.0

福建三元达软件有限公司

二○一四年六月

文档变更说明

版本编号变更

类型

简要说明（变更内容和变更范围）日期变更人

V1.0 新建创建并拟制初稿2014/6/24 朱有文变更类型：新建，修改，增加，删除

目录

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函数说明 (15)

6.3调用过程 (18)

7.写卡器设备功能域接口 (18)

7.1组件名称 (18)

7.2函数说明 (19)

7.3调用过程 (23)

8.银行卡读卡器设备功能域接口 (24)

8.1组件名称 (24)

8.2函数说明 (24)

8.3调用过程 (27)

9.一体机组件名称 (28)

10.一体机接口规范 (28)

1)一体机二代证读卡 (28)

2)一体机SIM卡读写卡 (28)

3)一体机打印机 (28)

1. 前言

近几年，随着Android、iOS等智能终端操作系统的推广，智能终端功能越来越丰富，越来越被大众所接受，移动互联网正欣欣向荣。智能终端具有体积小、携带方便、移动办公等优势。移动顺应时代潮流，利用移动互联网新技术，采取更为积极主动的营销和服务模式，也建立了包括智能终端版CRM等移动应用，完善了自身的运营支撑能力，以适应市场的需要，提升了自身竞争力，保持自身的行业优势。

移动智能终端应用在业务办理过程中，使用到了多种多样的外接设备辅助办公，如蓝牙打印机、蓝牙二代证读卡器、蓝牙SIM信息读卡器等，为企业办公、客户带来的极大的方便。与此同时也带来了问题，同种设备不同厂商在实现方式上各有差别，要兼容不同的外设厂商就必须付出等量的劳动力。因此建立一套智能终端外设接口规范刻不容缓。

智能终端外设接口规范明确了外设接入移动智能终端应用的技术规范、业务功能，以指导各外设厂家如何根据规范接入移动智能终端应用。

2. 目的范围

智能终端外设接口规范适用于指导各外设厂家将其外设按照规范合理、高效、快速地接入移动智能终端应用，是各外设厂家接入移动智能终端应用的主要依据。本规范规定了外设的技术规范、业务功能，操作流程。

3. 原则

本规范尽可能依据现有外设的行业技术规范，并能尽量最大化兼容各外设厂商。

4. 术语及缩略语

下列术语和缩略语适用于本规范：

Android 是一种以Linux为基础的开放源码操作系统，主要使用于便携设备。

iOS iOS是由苹果公司开发的手持设备操作系统。iOS与苹果的Mac OS X操作系统一样，它也是以Darwin为基础的，因此同样属于类Unix的商业操作

系统。

客户是指一个正在使用及可能使用移动（包括第三方合作伙伴）提供的产品和服务的个人、企业或者其他团体。

蓝牙是一种支持设备短距离通信（一般10m内）的无线电技术。能在包括移动电话、PDA、无线耳机、笔记本电脑、相关外设等众多设备之间进行无线信息

交换。

用户用户是移动客户订购产品的实例。包括资源占用、用户价值、订购信息。

智能终端是指像个人电脑一样，具有独立的操作系统，可以由用户自行安装软件、游戏等第三方服务商提供的程序，通过此类程序来不断对终端的功能进

行扩充，并可以通过移动通讯网络来实现无线网络接入的这样一类终端

的总称。

二代证第二代居民身份证

CRM 客户关系管理(Customer Relationship Management)

SIM 用户识别卡（Subscriber Identity Module）

5. 写卡器设备功能域接口

5.1组件名称

CMCC_PRINT_厂家英文名缩写_厂家设备型号缩写.so

5.2函数说明

1)连接打印机

方法描述连接打印机

包名+类名com.cmcc.nativepackage.Printer

方法名public static native int openPrinter(int printerType,String

deviceId,String password)

属性变量名称类型变量含义备注

入口参数printerType int 打印机类型printerType

1：USB打印机(包括USB

智能终端外设一体机中

的打印机)

2：蓝牙打印机（包括蓝

牙智能终端外设一体机

中的打印机）

3：串口打印机（包括串

口智能终端外设一体机

中的打印机）

4、内置打印机（包括智

能终端一体机中的打印

机）

入口参数deviceId String 设备ID 当printerType为2时，

deviceId为打印机MAC

地址。

当printerType为3时，

deviceId为USB 卡(线)

转换的串口，如

/dev/ttyUSB0。

入口参数password String 密码预留字段

返回值int 0－>Success；

非0状态码－> Fail 附加说明password是为了将来可能出现的wifi设备预留的参数。

2)关闭打印机

方法描述关闭与打印机的连接

包名+类名com.cmcc.nativepackage.Printer

方法名public static native int closePrinter()

属性变量名称类型变量含义备注

返回值int 0－>Success；

非0状态码－> Fail 附加说明无

3)获取组件版本信息

方法描述获取各厂商打印机组件的版本信息。

包名+类名com.cmcc.nativepackage.Printer

方法名public static native int getPrinterVersion(byte[] version)

属性变量名称类型变量含义备注

出口参数version byte[] 版本号各厂商打印机组件的版

本号(三位整数)，数值

越大代表版本越高。返回值int 0－>Success；

非0状态码－> Fail 附加说明无

4)初始化打印机

方法描述初始化打印机，清除打印缓冲区中的数据，复位打印机打印参数到打印