一体化终端设备技术规范

1、智能终端接口规范版本号1.0福建三元达软件有限公司二。一四年六月文档变更说明版本编R艾更简要说明（变更内容和交更范围）日期艾更人V1.0新建创建并拟制初稿2014/6/24朱启文变更类型：新建，修改，增加，删除目 录1. 前言42. 目的范围53. 原则54. 术语及缩略语55. 写卡器设备功能域接口 65.1 组件名称65.2 函数说明65.3 调用过程146. 二代证身份识别设备功能域接口 146.1 组件名称146.2 函数说明156.3 调用过程187. 写卡器设备功能域接口 187.1 组件名称187.2 函数说明197.3 调用过程238. 银行卡读卡器设备功能域接口 248.1

2、组件名称248.2 函数说明248.3 调用过程279. 一体机组件名称 2810. 一体机接口规范 281) 一体机二代证读卡 282) 一体机 SIM卡读写卡 283) 一体机打印机281 .刖百近几年，随着Android、iOS等智能终端操作系统的推广，智能终端功能越来越丰富，越来 越被大众所接受，移动互联网正欣欣向荣。智能终端具有体积小、携带方便、移动办公等优势。移动顺应时代潮流，利用移动互联网新技术，采取更为积极主动的营销和服务模式，也建立了包括智能终端版CRM等移动应用，完善了自身的运营支撑能力，以适应市场的需要，提升了自身竞争力，保持自身的行业优势。移动智能终端应用在业务办理过程

3、中，使用到了多种多样的外接设备辅助办公，如蓝牙打印机、蓝牙二代证读卡器、蓝牙 SIM信息读卡器等，为企业办公、客户带来的极大的方便。与此同 时也带来了问题，同种设备不同厂商在实现方式上各有差别，要兼容不同的外设厂商就必须付出等量的劳动力。因此建立一套智能终端外设接口规范刻不容缓。智能终端外设接口规范明确了外设接入移动智能终端应用的技术规范、业务功能，以指导各外设厂家如何根据规范接入移动智能终端应用。2 .目的范围智能终端外设接口规范适用于指导各外设厂家将其外设按照规范合理、高效、快速地接入移动智能终端应用，是各外设厂家接入移动智能终端应用的主要依据。本规范规定了外设的技术规范、业务功能，操作流

4、程。3 .原则本规范尽可能依据现有外设的行业技术规范，并能尽量最大化兼容各外设厂商。4 .术语及缩略语下列术语和缩略语适用于本规范：Android是一种以Linux为基础的开放源码操作系统，主要使用于便携设备。iOSiOS是由苹果公司开发的手持设备操作系统。iOS与苹果的Mac OS XI作系统一样，它也是以Darwin为基础的，因此同样属于类 Unix的商业操作 系统。客户是指一个正在使用及可能使用移动(包括第三方合作伙伴)提供的产品和服务的个人、企业或者其他团体。蓝牙是一种支持设备短距离通信(一般10m内)的无线电技术。能在包括移动电话、PDA无线耳机、笔记本电脑、相关外设等众多设备之间进

5、行无线信息 交换。用户用户是移动客户订购产品的实例。包括资源占用、用户价值、订购信息。智能终端是指像个人电脑一样，具有独立的操作系统，可以由用户自行安装软件、游戏等第三方服务商提供的程序，通过此类程序来不断对终端的功能进行扩充，并可以通过移动通讯网络来实现无线网络接入的这样一类终端 的总称。二代证第二代居民身份证CRM客户关系管理(Customer Relationship Management)SIM用户识别卡(Subscriber Identity Module )5 .写卡器设备功能域接口5.1 组件名称CMCC PRINT厂家英文名缩写厂家设备型号缩写.so5.2 函数说明1）连接打印

6、机方法描述连接打印机包名+类名com.cmcc.nativepackage.Printer方法名public static native int openPrinter(int printerType,String deviceId,String password)属性变量名称变量含义备注入口参数printerTypeint打印机类型printerType1: USBCT机（包才USB智能终端外设一体机中的打印机）2:蓝牙打印机（包括蓝牙智能终端外设一体机中的打印机）3:串口打印机（包括串口智能终端外设一体机中的打印机）4、内置打印机（包括智能终端一体机中的打印机）入口参数deviceIdSt

7、ring设备ID当 printerType 为 2 时， deviceId 为打印机MAC 地址。当 printerType 为 3 时， deviceId 为 USB 卡（线） 转换的串口，如/dev/ttyUSB0 。入口参数passwordString密码预留字段返回值int0 >Success ;非0状态码> Fail附加说明password是为了将来可能出现的wifi设备预留的参数。2）关闭打印机方法描述关闭与打印机的连接包名+类名com.cmcc.nativepackage.Printer方法名public static native int closePrinter(

8、)属性变量名称变量含义备注返回值int0 >Success ;非0状态码> Fail附加说明无3）获取组件版本信息方法描述获取各厂商打印机组件的版本信息。包名+类名com.cmcc.nativepackage.Printer方法名public static native int getPrinterVersion(byte口 version)属性变量名称变量含义备注出口参数versionbyte版本号各厂商打印机组件的版 本号（三位整数），数值 越大代表版本越高。返回值int0 >Success ;非0状态码> Fail附加说明无4）初始化打印机方法描述初始化打印机，清

9、除打印缓冲区中的数据，复位打印机打印参数到打印方法描述初始化打印机，清除打印缓冲区中的数据，复位打印机打印参数到打印机缺省参数。包名+类名com.cmcc.nativepackage.Printer方法名public static native int initialPrinter()属性变量名称变量含义备注返回值int0 >Success ;非0状态码> Fail附加说明不是完全恢复到出厂设置，只是将打印指令参数恢复到打印机缺省参数。点距是指打印的内容每个点之间的距离。具体缺省设置包括如下：1 .字体宽图缩放比例：1;2 .对齐方式：左对齐；3 .左边距：0个点距；4 .右边距：

10、0个点距；5 .行间距：8个点距；6 .字符间距：。个点距；7 .打印方向：横打；8 .非粗体打印；9 .非下划线打印；10 .非反白打印。5）设置字体宽高缩放比例方法描述设置打印机字符串的字符宽高缩放比例。包名+类名com.cmcc.nativepackage.Printer方法名public static native int setZoonIn(int widthZoonIn,int heightZoonIn)属性变量名称变量含义备注入口参数widthZoonInint字体放大宽度相比正常字体宽度的倍数，必须是正整数入口参数heightZoonI nint字体放大高度相比正常字体高度的倍

11、数，必须是正整数。返回值int0 >Success ;非0状态码> Fail附加说明打印机字体宽高缩放比例缺省设置为 1。厂商必须支持宽高缩放比为正常字体两倍或以上。6）设置对齐方式方法描述设置打印机字符串的对齐方式。包名+类名com.cmcc.nativepackage.Printer方法名public static native int setAlignType(int alignType)属性变量名称变量含义备注入口参数alignTypeint对齐方式0:左对齐；1：居中对齐；2:右对齐返回值int0 >Success ;非0状态码> Fail附加说明1 .打印机

12、缺省设置为左对齐。2 .仅在一行开始处理时，该命令才有效。3 .竖向打印不支持设置对齐方式，默认上对齐。7）设置左边距方法描述设置打印机每行字符左边距为n个点距包名+类名com.cmcc.nativepackage.Printer方法名public static native int setLeftMargin(int n)属性变量名称变量含义备注入口参数nint左边点距返回值int0 >Success ;非0状态码> Fail附加说明1 .左边距位置表示打印内容的左侧边缘位置。2 .点距是指打印的内容每个点之间的距离。8）设置右边距方法描述设置打印机每行字符右边距为n个点距包名+

13、类名com.cmcc.nativepackage.Printer方法名public static native int setRightMargin(int n)属性变量名称变量含义备注入口参数nint右边点距返回值int0 >Success ;非0状态码> Fail附加说明1 .右边距位置表示打印内容的右侧边缘位置。2 .点距是指打印的内容每个点之间的距离。9)设置行间距方法描述设置打印机字符串的字符行间距为n个垂直点距包名+类名com.cmcc.nativepackage.Printer方法名public static native int setLineSpacingByDo

14、tPitch (int n)属性变量名称变量含义备注入口参数nint垂直点距返回值int0 >Success ;非0状态码> Fail附加说明1 .打印机行间距缺省设置为 8。2 .仅在一行开始处理时，该命令才有效。3 .点距是指打印的内容每个点之间的距离。10) 设置字符间距方法描述设置打印机字符串的字符间距为n个水平点距包名+类名com.cmcc.nativepackage.Printer方法名public static native int setWordSpacingByDotPitch(int n)属性变量名称变量含义备注入口参数nint水平点距取值范围：0W n <

15、;255返回值int0 >Success ;非0状态码> Fail附加说明1 .打印机字符间距缺省设置为0。2 .在倍宽模式下，字符右侧间距是正常值的两倍。当字符被放大时，字符右侧间距被放大同样的倍数。该函数同时影响英文和汉字字符的设定。3.点距是指打印的内容每个点之间的距离。11) 设置打印方向方法描述设置打印机字符串的打印方向包名+类名com.cmcc.nativepackage.Printer方法名public static native int setPrintOrientation(int printOrientation)属性变量名称变量含义备注入口参数nprintOr

16、ientation打印方向0:竖打1:横打返回值int0 >Success ;非0状态码> Fail附加说明1 .打印机缺省设置为横打。2 .设置打印方向后，所有的打印都按照此格式打印。3 .竖向不支持设置对齐方式，默认上对齐。12) 设置/取消粗体打印方法描述设置打印机字符串是否粗体打印包名+类名com.cmcc.nativepackage.Printer方法名public static native int setBold(int n)属性变量名称变量含义备注入口参数nint是否粗体0：取消粗体打印设置；1:设置粗体打印返回值int0 >Success ;非0状态码>

17、; Fail附加说明打印机缺省设置为非粗体打印。13) 设置/取消下划线打印方法描述设置打印机字符串是否卜划线打印包名+类名com.cmcc.nativepackage.Printer方法名public static native int setUnderLine(int n)属性变量名称变量含义备注入口参数nint是否卜划线打印0:取消下划线打印；1:设置卜划线打印返回值int0 >Success ;非0状态码> Fail附加说明打印机缺省设置为非下划线打印。14) 设置/取消反白打印方法描述设置打印机字符串是否反白打印包名+类名com.cmcc.nativepackage.Pr

18、inter方法名public static native int setInverse(int n)属性变量名称变量含义备注入口参数nint是否反白打印0:取消反白打印；1:设置反白打印返回值int0 >Success ;非0状态码> Fail附加说明打印机缺省设置为非反白打印。15) 打印字符串方法描述打印字符串包名+类名com.cmcc.nativepackage.Printer方法名public static native int print(String content)属性变量名称变量含义备注入口参数contentString打印字符串打印字符串，可包括多行打印数据，使用

19、“n " 表小换行。返回值int0 >Success ;非0状态码> Fail附加说明当每行数据超出打印纸张宽度时打印机输出自动换行。16) 打印HTML格式数据方法描述打印HTML格式数据包名+类名com.cmcc.nativepackage.Printer方法名public static native int printHTML(String content)属性变量名称变量含义备注入口参数contentStringHTML格市据返回值int0 >Success ;非0状态码> Fail附加说明支持常用html标签。5.3调用过程1、加载组件，调用加载外设

20、组件流程。2、建立与热敏打印机的连接。3、调用组件的初始化打印机方法。4、调用组件的设置打印机参数方法集，如设置对齐方式、设置行间距等方法。5、调用组件的打印字符或打印HTML格式数据方法。6、打印机打印票据。7. 关闭连接。6.二代证身份识别设备功能域接口6.1 组件名称CMCC IDCARD厂家英文名缩写厂家设备型号缩写.so6.2 函数说明1）连接二代证身份识别设备方法描述连接二代证身份识别设备包名+类名com.cmcc.nativepackage.IDCard方法名public static native int openIDCard(int idCardType,String dev

21、iceId,String password)属性变量名称变量含义备注入口参数idCardTypeint二代证身份识别设备类型idCardType1: USB二代证身份识别 设备（包才USBW能终端 外设一体机中的二代证 身份识别设备）2:蓝牙二代证身份识别 设备（包括蓝牙智能终 端外设一体机中的二代 证身份识别设备）3:串口二代证身份识别 设备（包括串口智能终 端外设一体机中的二代 证身份识别设备）4、内置二代证身份识别 设备（包括智能终端一 体机中的二代证身份识 别设备）入口参数deviceIdString设备ID当 idCardType 为 2 时 deviceId 为蓝牙二代证 身份识别

22、设备MACM址 当 idCardType 为 3时 deviceId 为 USB 卡（线） 转换的串口，如 /dev/ttyUSB0 。入口参数passwordString密码预留字段返回值int0 >Success ;非0状态码> Fail附加说明password是为了将来可能出现的wifi设备预留的参数。2）关闭二代证身份识别设备方法描述关闭与二代证身份识别设备的连接包名+类名com.cmcc.nativepackage.IDCard方法名public static native int closeIDCard()属性变量名称变量含义备注返回值int0 >Success

23、;非0状态码> Fail附加说明无3）获取组件版本信息方法描述获取各厂商二代证身份识别设备组件的版本信息。包名+类名com.cmcc.nativepackage.IDCard方法名public static native int getIDCardVersion(byte口 version)属性变量名称变量含义备注出口参数versionbyte口版本号各厂商二代证身份识别 设备组件的版本号（三 位整数），数值越大代表 版本越高。返回值int0 >Success ;非0状态码> Fail附加说明无4）初始化二代证身份识别设备方法描述初始化二代证身份识别设备，清除二代证身份识别设

24、备内缓存数据。方法描述初始化二代证身份识别设备，清除二代证身份识别设备内缓存数据。包名+类名com.cmcc.nativepackage.IDCard方法名public static native int initialIDCard ()属性变量名称变量含义备注返回值int0 >Success ;非0状态码> Fail附加说明无5）获得二代证信息方法描述获得二代证信息包名+类名com.cmcc.nativepackage.IDCard方法名public static native int getIdCardInfo(String idCardInfo,byte口 img)属性变量名

25、称变量含义备注出口参数idCardInfoString二代证基本信息数组长度为9,内容按顺 序分别为：姓名、性别、 民族、出生年月、地址、 公民身份号码、签发机 关、有效期限，照片保 存地址。出口参数imgbyte照片文件内容证件头彳t图片BASE6编码返回值int0 >Success ;非0状态码> Fail附加说明无6.3 调用过程1、加载组件，调用加载外设组件流程。2、 建立与二代证身份识别设备的连接。3、调用组件的初始化二代证身份识别设备方法o4、调用组件的获取二代证信息方法。5、 页面显示二代证身份信息。6、 关闭连接。7、 写卡器设备功能域接口7.1 组件名称CMCC

26、SIMCARD厂家英文名缩写厂家设备型号缩写.so7.2函数说明1）获取版本信息方法描述通过该函数获取统一写卡组件的版本信息。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetOPSVersion( char Version)属性变量名称变量含义备注出口参数Versionchar版本号方法返回，统一写卡组件版本信息返回值int0 >Success ;非0状态码> Fail附加说明无2）读空卡序列号方法描述该函数用于读取卡片空卡序列号，该函数支持本标准发布前和发布后的所有现场写卡系统空卡。因此 CR廨户

27、端可通过调用 GetCardSN判断是否为本标准 发布后生产的空卡。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetCardSN(char口 CardSN)属性变量名称变量含义备注出口参数CardSNchar空卡序列号空卡序列号，如卡片符合中国移动SIM卡远程写卡业务规范 v1.0.0版本，则长度为16位， 如卡片符合中国移动现场写卡技术规范， 则长度为20位。返回值int0 >Success ;非0状态码> Fail附加说明无3)读取卡片信息方法描述该函数用于读取卡片信息，卡片信息包含卡片ICCI

28、D、卡片空卡序列号.包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetCardInfo (char口 CardInfo)属性变量名称变量含义备注出口参数CardInfochar该参数包含卡片ICCID、卡片空卡序列号格式【iccid+(iccid+. )+空卡序列号】该参数包含卡片 ICCID、卡片空卡序列 号。格式为TL婚式，具 体参见« NGBOSS2-CRM(V4 5) (U)SIM卡写卡技术规范 支撑分册 20130722.doc » 第8.3.3节。其中卡片 ICCID如果为一卡多号

29、 卡，可出现多次。具体 请参见« NGBOSS2-CRM(V4 5) (U)SIM卡写卡技术规范 支撑分册 20130722.doc » 第7.7 f多"写卡 及第8.2.1节空卡判断。返回值int0 >Success ;非0状态码> Fail附加说明无4)实时写卡数据写入方法描述该函数用于实时写卡数据写入。函数返回值为0时表示统一写卡组件向卡片发送写卡数据成功并得到卡片响应。写卡是否成功须根据Result判断.包名+类名com.cmcc.nativepackage.SimCard方法名public static native int WriteCar

30、d(char IssueData, char Result)属性变量名称变量含义备注入口参数IssueDatachar现场写卡系统 生成的写卡下 行报文现场写卡系统生成的写 卡下行报文，如多条报 文，用“ | ”分隔。出口参数Resultchar卡片返回结果卡片返回结果，格式参见« NGBOSS2-CRM(V4 5) (U)SIM卡写卡技术规范 支撑分册 20130722.doc » 第8.3.3.2 节中第3部分“返回数据格式”说明。CR响现场写卡系统回传 写卡结果时须传带MACt的完整结果。返回值int0 >Success ;非0状态码> Fail附加说明无

31、5)获取错误信息方法描述该函数用于获取错误信息，统一写卡组件将返回最次函数调用的错 误信息。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetOPSErrorMsg(int ErrorCode, char ErrorMsg)属性变量名称变量含义备注出口参数ErrorCodeint取近次接口 调用的错误代 码该参数为统一写卡组件 最近一次接口调用的错 误代码，如最近一次执行 成功则该参数返回0。出口参数ErrorMsgchar取近次接口 调用的错误描 述该参数为统一写卡组件 最近一次接口调用的错 误描述，如最近一次

32、执行 成功则该参数返回字符 串“NoError ”。返回值int0 >Success ;非0状态码> Fail附加说明无6）获取读卡器信息方法描述通过该函数连接误卡器。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int ConfigReader(int ReaderType, char DeviceID, charPassword)属性变量名称变量含义备注入口参数ReaderTypeint1、 USB 读卡器 （CM-READER议）；2、 蓝牙假卡器；3、串口读 卡器；4、内置诺卡器入口参数DeviceID

33、char设备号1 .ReaderType 为 1 时取值 如下：WINDOWS: PCS犊 卡器名称，Linux: PCSC读 卡器名称Android:USB读 卡器VID+PID的16进制字 符串，如 VID为23D8, PID 为0185,则值为 23D801852 .ReaderType 为 2 时为蓝 牙读卡器MA电址的16进 制字符串，如读卡器MAC 地址为11:22:33:44:55:66, 则值为 112233445566。3 .ReaderType 为 3 时取值 如下：WINDOWS:串口名 称，如 COM1 Linux: 终 端主机自带的串口，如/dev/ttyS0US陈（

34、线）转换的串口， 如/dev/ttyUSB0Android: 终端主机自 带的串口， 如/dev/ttyS0US陈（线）转换的串口， 如/dev/ttyUSB04 .ReaderType 为 4 时取值 如下：可以设置为固定值，也可以不配置入口参数Passwordchar蓝牙诙卡器连接密码蓝牙读卡器连接密码，该 字段为预留字段。返回值int0 >Success ;非0状态码> Fail附加说明无7.3调用过程读卡智能终端版CRM客户端写卡器.加载外设组件2.加载读卡器控制组件3.加载统一写卡组件4.调用外设组件读卡5.返回读卡结果图3读卡流程图1、加载组件，调用加载外设组件流程。2

35、、 通过外设组件相关函数调用统一写卡组件各函数进行读卡3、 显不'读卡结果。1、加载组件，调用加载外设组件流程。写卡流程图2、通过外设组件相关函数调用统一写卡组件各函数进行写卡，具体步骤请参见中国移3、显示写卡结果。动现场写卡技术规范2.0。8.银行卡读卡器设备功能域接口8.1 组件名称CMCC BANKCARD厂家英文名缩写 厂家设备型号缩写.so8.2 函数说明1）连接银行卡读卡器设备方法描述连接银行卡诺卡器设备包名+类名com.cmcc.nativepackage.BankCard方法名public static native int openBankCard(int bankC

36、ardType,String deviceId,String password)属性变量名称类型变量含义备注入口参数bankCardTypeint银行卡读卡器设备类型bankCardType1: USB银行卡读卡器设备（包才USB智能终端外设一体机中的银行卡读卡器设备）2:蓝牙银行卡读卡器设备（包括蓝牙智能终端外设一体机中的银行卡读卡器设备）3:串口银行卡读卡器设备（包括串口智能终端外设一体机中的银行卡读卡器设备）4、内置银行卡读卡器设备（包括智能终端一体机中的银行卡读卡器设备）入口参数deviceIdString设备ID当 bankCardType 为 2 时， deviceId为银行卡读卡器 设备MAC地址。当 bankCardType 为 3 时， deviceId 为 USB 卡（线）转 换的串口，如/dev/ttyUSB0。入口参数passwordString密码预留字段返回值int0 >Success；状态码