一体化终端设备技术示范.docx

《一体化终端设备技术示范.docx》由会员分享，可在线阅读，更多相关《一体化终端设备技术示范.docx（35页珍藏版）》请在三一文库上搜索。

1、智能终端接口规范版本号1.0福建三元达软件有限公司二。一四年六月文档变更说明版本编R艾更简要说明（变更内容和交更范围）日期艾更人V1.0新建创建并拟制初稿2014/6/24朱启义变更类型：新建，修改，增加，删除目 录1. 前言52. 目的范围63. 原则64. 术语及缩略语65. 写卡器设备功能域接口 75.1 组件名称75.2 函数说明75.3 调用过程166. 二代证身份识别设备功能域接口 176.1 组件名称176.2 函数说明176.3 调用过程207. 写卡器设备功能域接口 217.1 组件名称217.2 函数说明217.3 调用过程278. 银行卡读卡器设备功能域接口 298.1

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

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

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

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

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

7、印 机）入口参数deviceldString设备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 nativ

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

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

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

11、nt0 >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 .打印机缺省设置为左对齐。2 .仅

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

13、tivepackage.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 setLineSpacingByDotPitch (int n)属

14、性变量名称变量含义备注入口参数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 w 255返回值int0 >S

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

16、竖打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状态码> Fail附加说明打印机

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

18、ic 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打印字符串打印字符串，可包括多 行打印数据，使用“ n "

19、 表小换行。返回值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 device

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

22、址当 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 ;非0状态码

23、> 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 initiallDCard ()属性变量名称变量含义备注返回值int0 >Success ;非0状态码> Fail附加说明无5）获得二代证信息方法描述获得二代证信息包名+类名com.cmcc.nativepackage.IDCard方法名public static native int getIdCardInfo(String idCardInfo,byte口 img)属性变量名称变量含义备注出口参数idCardInfoString口二代证基本信息数组长度为9,内

25、容按顺 序分别为：姓名、性别、 民族、出生年月、地址、 公民身份号码、签发机 关、有效期限，照片保 存地址。出口参数imgbyte口照片文件内容证件头彳t图片 BASE64编码返回值int0 >Success ;非0状态码> Fail附加说明无6.3 调用过程智能终端版CRM客户端二代证身份识别设备!一1 i加载组件：.件2 .调用3 .调用组件：初始化IJ4 .调用;5 .显示二代身份证信息T6 .调用组件：关闭连接图2二代证身份识别流程图示1、加载组件，调用加载外设组件流程。2、建立与二代证身份识别设备的连接。3、调用组件的初始化二代证身份识别设备方法。4、调用组件的获取二代证

26、信息方法。5、页面显示二代证身份信息o6、关闭连接。7.写卡器设备功能域接口7.1 组件名称CMCC_SIMCARD_厂家英文名缩写厂家设备型号缩写.so7.2函数说明1）获取版本信息方法描述通过该函数获取统一写卡组件的版本信息。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetOPSVersion (char口 Version)属性变量名称变量含义备注出口参数Versionchar口版本号方法返回，统一写卡组件版本信息返回值int0 >Success ;非0状态码> Fail附加说明无2）读空卡序列

27、号方法描述该函数用于读取卡片空卡序列号，该函数支持本标准发布前和发布后的所有现场写卡系统空卡。因此CRM客户端可通过调用 GetCardSN判断是否为本标准发布后生产的空卡。包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetCardSN(char口 CardSN)属性变量名称变量含义备注出口参数CardSNchar口空卡序列号空卡序列号，如卡片符 合中国移动SIM卡远 程写卡业务规范V1.0.0 版本，则长度为16位， 如卡片符合中国移动现场写卡技术规范， 则长度为20位。返回值int0 >Success

28、;非0状态码> Fail附加说明无3)读取卡片信息方法描述该函数用于读取卡片信息，卡片信息包含卡片ICCID、卡片空卡序列号.包名+类名com.cmcc.nativepackage.SimCard方法名public static native int GetCardInfo (char口 CardInfo)属性变量名称变量含义备注出口参数CardInfochar口该参数包含卡片ICCID、卡片空卡序列号格式【iccid+(iccid+. ) +空卡序列号】该参数包含卡片ICCID、卡片空卡序列号。格式为TLV格式，具体参见« NGBOSS2-CRM(V45) (U)SIM卡写卡

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

30、SimCard方法名public static native int WriteCard(char口 IssueData, char口 Result)属性变量名称变量含义备注入口参数IssueDatachar口现场写卡系统 生成的写卡下 行报文现场写卡系统生成的写 卡下行报文，如多条报 文，用“ |”分隔。出口参数Resultchar口卡片返回结果卡片返回结果，格式参见« NGBOSS2-CRM(V45) (U)SIM卡写卡技术规范支撑分册20130722.doc» 第8.3.3.2节中第3部分“返回数据格式”说明。CRM向现场写卡系统回传写卡结果时须传带MAC值的完整结果

31、。返回值int0 >Success ;非0状态码> Fail附加说明无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 natDeviceID, charve int ConfigReader(int ReaderType, char口Password)属性变量名称变量含义备注入口参数ReaderTypeint1、USB 口读卡器（CM-READER 协议）；2、蓝牙

33、假卡器；3、串口误卡器；4、内置唐卡器入口参数DevicelDchar口设备号I.ReaderType 为 1 时取 值如下：WINDOWS: PCSC读卡器名称，Linux: PCSC读卡器名称 Android:USB 读卡器VID+PID 的16进制字符 串，如 VID 为23D8 , PID 为0185 , 则值为 23D801852 .ReaderType 为 2 时为 蓝牙读卡器 MAC地址的 16进制字符串，如读卡器 MAC地址 为11:22:33:44:55:66,则值为112233445566。3 .ReaderType 为 3 时取 值如下：WINDOWS: 串 口名称，如C

34、OM1 Linux:终端主机自带的 串口，如 /dev/ttyS0USB卡（线）转换的串口，如/dev/ttyUSB0Android: 终端主机自带的串口， 如/dev/ttyS0USB卡（线）转换的串口，如/dev/ttyUSB04.ReaderType 为 4 时取值如下：可以设置为固定值，也可以不配置入口参数Passwordchar口蓝牙连接密码蓝牙读卡器连接密码，该字段为预留字段。返回值int0 >Success ;非0状态码> Fail附加说明无7.3调用过程图3读卡流程图1、加载组件，调用加载外设组件流程。2、 通过外设组件相关函数调用统一写卡组件各函数进行读卡3、 显

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

36、 password)属性变量名称类型变量含义备注入口参数bankCardTypeint银行卡读卡器设备类型bankCardType1 : USB银行卡读卡器设备（包才USB智能终端外设一体机中的银行卡读卡器设备）2:蓝牙银行卡读卡器设备（包括蓝牙智能终端外设一体机中的银行卡读卡器设备）3:串口银行卡读卡器设备（包括串口智能终端外设一体机中的银行卡读卡器设备）4、内置银行卡读卡器设备（包括智能终端一体机中的银行卡读卡器设备）入口参数deviceIdString设备ID当 bankCardType 为 2 时，deviceId 为银行卡读 卡器设备 MAC地址。当 bankCardType 为 3

37、 时，deviceId 为 USB 卡 （线）转换的串口，如 /dev/ttyUSB0 。入口参数passwordString密码预留字段返回值int0 >Success ；状态码> Fail附加说明password 是为了将来可能出现的wifi设备预留的参数。2）关闭银行卡读卡器设备方法描述关闭与银行卡诺卡器设备的连接包名+类名com.cmcc.nativepackage.BankCard方法名public static native int closeBankCard()属性变量名称类型变量含义备注返回值int0 >Success ；非0状态码> Fail附加说明无

38、3）获取组件版本信息方法描述获取各厂商银行卡读卡器组件的版本信息。包名+类名com.cmcc.nativepackage.BankCard方法名public static native int getBankCardVersion(byte口 version)属性变量名称类型变量含义备注出口参数versionbyte口版本号各厂商银行卡读卡器组 件的版本号（三位整数）， 数值越大代表版本越高。返回值int0 >Success ；非0状态码> Fail附加说明无4）初始化银行卡读卡器方法描述初始化银行卡读卡器，清除银行卡读卡器内缓存数据。包名+类名com.cmcc.nativepac

39、kage.BankCard方法名public static native int initialBankCard ()属性变量名称类型变量含义备注返回值int0 >Success ；非0状态码> Fail附加说明无5）获得银行卡信息方法描述获得银行卡各磁道数据。包名+类名com.cmcc.nativepackage.BankCard方法名public static native int getBankCardInfo(byte口 firstTrack, byte口 secondTrack, byte thirdTrace)属性变量名称类型变量含义备注出口参数firstTrackby

40、te口第一磁道数据出口参数secondTrackbyte口第二磁道数据出口参数thirdTrackbyte口第三磁道数据返回值int0 >Success ；非0状态码> Fail附加说明无8.3 调用过程智能终端版CRM客户端银行卡读卡器1.加载组件2.调用组件：建立连接3.调用组件：初始化4.调用组件：获取银行卡信息5 .显示银行卡信息6 .调用组件：关闭连接图5银行卡读卡流程图示1、加载组件，调用加载外设组件流程。2、建立与银行卡读卡器设备的连接。3、调用组件的初始化银行卡读卡器方法。4、调用组件的获取银行卡信息方法。5、 页面显示银行卡信息。6、关闭连接。9. 一体机组件名称CMCC_UNITDEVICE_厂家英文名缩写厂家设备型号缩写.so10. 一体机接口规范1) 一体机二代证读卡请参见本文档79规范2) 一体机SIM卡读写卡请参见本文档 1012 规范3) 一体机打印机请参见本文档46规范