一体化终端设备技术规范

下载jre时出现的几个常见问题智能终端接口规范版本号1.0福建三元达软件有限公司二○一四年六月页脚内容1下载jre时出现的几个常见问题文档变更说明版变本编更类号型变简要说明（变更内容和变更范围）日期更人V2014/新创建并拟制初稿朱1.06/24建有文页脚内容2下载jre时出现的几个常见问题变更类型：新建，修改，增加，删除页脚内容3下载jre时出现的几个常见问题目录1.前言围则语口72.目的范83.原84.术语及缩略85.写卡器设备功能域接95.1组件名称.............................................................................................................................95.2函数说明.............................................................................................................................95.3调用过程...........................................................................................................................276.二代证身份识别设备功能域接口286.1组件名称...........................................................................................................................28页脚内容4下载jre时出现的几个常见问题6.2函数说明...........................................................................................................................286.3调用过程...........................................................................................................................347.写卡器设备功能域接口357.1组件名称7.2函数说明7.3调用过程8.银行卡读卡器设备功能域接口...........................................................................................................................35...........................................................................................................................35...........................................................................................................................44468.1组件名称8.2函数说明8.3调用过程...........................................................................................................................46...........................................................................................................................47...........................................................................................................................539.一体机组件名称5410.一体机接口规范......................................................................................................................541)一体机二代证读卡542)一体机SIM卡读写卡54页脚内容5下载jre时出现的几个常见问题3)一体机打印机54页脚内容6下载jre时出现的几个常见问题1.前言近几年，随着Android、iOS等智能终端操作系统的推广，智能终端功能越来越丰富，越来越被大众所接受，移动互联网正欣欣向荣。智能终端具有体积小、携带方便、移动办公等优势。移动顺应时代潮流，利用移动互联网新技术，采取更为积极主动的营销和服务模式，也建立了包括智能终端版CRM等移动应用，完善了自身的运营支撑能力，以适应市场的需要，提升了自身竞争力，保持自身的行业优势。移动智能终端应用在业务办理过程中，使用到了多种多样的外接设备辅助办如蓝牙打印机、蓝牙二代证读卡器、蓝牙SIM信息读卡器等，为企业办公、客户带来的极大的方便。与此同时也带来了问题，同种设备不同厂商在实现方式公，上各有差别，要兼容不同的外设厂商就必须付出等量的劳动力。因此建立一套智能终端外设接口规范刻不容缓。智能终端外设接口规范明确了外设接入移动智能终端应用的技术规范、业务功能，以指导各外设厂家如何根据规范接入移动智能终端应用。页脚内容7下载jre时出现的几个常见问题2.目的范围智能终端外设接口规范适用于指导各外设厂家将其外设按照规范合理、高应用的主要效、快速地接入移动智能终端应用，是各外设厂家接入移动智能终端依据。本规范规定了外设的技术规范、业务功能，操作流程。3.原则本规范尽可能依据现有外设的行业技术规范，并能尽量最大化兼容各外设厂商。4.术语及缩略语下列术语和缩略语适用于本规范：AndroidiOS是一种以Linux为基础的开放源码操作系统，主要使用于便携设备。iOS是由苹果公司开发的手持设备操作系统。iOS与苹果的MacOSX操作系统一样，它也是以Darwin为基础的于类Unix的商业操作系统。，因此同样属客户是指一个正在使用及可能使用移动（包括第三方合作伙伴）提供的产品和服务的个人、企业或者其他团体。蓝牙是一种支持设备短距离通信（一般10m内）的无线电技术。能在包括移动电话、PDA、无线耳机、笔记本电脑、相关外设页脚内容8下载jre时出现的几个常见问题等众多设备之间进行无线信息交换。用户用户是移动客户订购产品的实例。包括资源占用、用户价值、订购信息。智能终端是指像个人电脑一样，具有独立的操作系统，可以由用户自行安装软件、游戏等第三方服务商提供的程序，通过此类程序来不断对终端的功能进行扩充，并可以通过移动通讯网络来实现无线网络接入的这样一类终端的总称。二代证CRM第二代居民身份证客户关系管理(CustomerRelationshipManagement)用户识别卡（SubscriberIdentityModule）SIM5.写卡器设备功能域接口5.1组件名称CMCC_PRINT_厂家英文名缩写_厂家设备型号缩写.so5.2函数说明1)连接打印机方法连接打印机页脚内容9下载jre时出现的几个常见问题描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintopenPrinter(intprinterType,String方法deviceId,Stringpassword)名属性变量名类型变量含备注称义printerint打印机printerType入口Type参数类型1：USB打印机(包括USB智能终端外设一体机中的打印机)2：蓝牙打印机（包括蓝牙智能终端外设一体机中的打印机）3：串口打印机（包括串口智能终端外设一体机中的打印机）4、内置打印机（包括智能终端一体机中的打印机）入口deviceIString设备ID当printerType为页脚内容10下载jre时出现的几个常见问题参数d2时，deviceId为打印机MAC地址。当printerType为3时，deviceId为USB卡(线)转换的串口，如/dev/ttyUSB0。passwoStringint密码预留字段入口rd参数0－>Success；非0状态码－>返回值Failpassword是为了将来可能出现的wifi设备预留的参数。附加说明2)关闭打印机方法关闭与打印机的连接描述类名名com.cmcc.nativepackage.Printer包名+方法publicstaticnativeintclosePrinter()页脚内容11下载jre时出现的几个常见问题属性变量名类型变量含备注称义返回int0－>Success；值非0状态码－>Fail附加无说明3)获取组件版本信息方法获取各厂商打印机组件的版本信息。描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintgetPrinterVersion(byte[]version)方法名属性变量名类型变量含备注称义versionbyte[]版本号各厂商打印机组出口参数件的版本号(三位整数)，数值越大代表版页脚内容12下载jre时出现的几个常见问题本越高。int0－>Success；返回附加值非0状态码－>Fail无说明4)初始化打印机方法初始化打印机，清除打印缓冲区中的数据，复位打印机打描述印参数到打印机缺省参数。com.cmcc.nativepackage.Printer包名+方法属性返回类名publicstaticnativeintinitialPrinter()名变量名类型变量含备注称义int0－>Success；值非0状态码－>Fail页脚内容13下载jre时出现的几个常见问题附加不是完全恢复到出厂设置，只是将打印指令参数恢复到打说明印机缺省参数。点距是指打印的内容每个点之间的距离。具体缺省设置包括如下：1.字体宽高缩放比例：1；2.对齐方式：左对齐；3.左边距：0个点距；4.右边距:0个点距；5.行间距：8个点距；6.字符间距：0个点距；7.打印8.非粗体打印9.非下10.非反白打印方向：横打；；划线打印；。5)设置字体宽高缩放比例方法设置打印机字符串的字符宽高缩放比例。页脚内容14下载jre时出现的几个常见问题描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetZoonIn(intwidthZoonIn,intheightZoonIn)方法名属性变量名类型变量含备注称义widthZintintint入口字体放相比正常字体宽oonIn参数参数大宽度度的倍数，必须是正整数heightZ入口字体放相比正常字体高oonIn大高度度的倍数，必须是正整数。0－>Success；返回值非0状态码－>Fail打印机字体宽高缩放比例缺省设置为1。附加说明厂商必须支持宽高缩放比为正常字体两倍或以上。页脚内容15下载jre时出现的几个常见问题6)设置对齐方式方法设置打印机字符串的对齐方式。描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetAlignType(intalignType)方法名属性变量名类型变量含备注称义alignTyintint对齐方0：左对齐；入口pe参数式1：居中对齐；2：右对齐返回0－>Success；值非0状态码－>Fail1.打印机缺省设置为左对齐。2.仅在一行开始处理时3.竖向打印附加说明，该命令才有效。不支持设置对齐方式，默认上对齐。页脚内容16下载jre时出现的几个常见问题7)设置左边距方法设置打印机每行字符左边距为n个点距描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetLeftMargin(intn)方法名属性变量名类型变量含备注称义nintint入口左边点参数距返回0－>Success；值非0状态码－>Fail1.左边距位置表示打印内容的左侧边缘位置。附加说明2.点距是指打印的内容每个点之间的距离。页脚内容17下载jre时出现的几个常见问题8)设置右边距方法设置打印机每行字符右边距为n个点距描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetRightMargin(intn)方法名属性变量名类型变量含备注称义nintint右边点入口参数距返回0－>Success；非0状态码－值>Fail1.右边距位置表示打印内容的右侧边缘位置。附加说明2.点距是指打印的内容每个点之间的距离。页脚内容18下载jre时出现的几个常见问题9)设置行间距方法设置打印机字符串的字符行间距为n个垂直点距描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetLineSpacingByDotPitch(intn)方法名属性变量名类型变量含备注称义nintint入口垂直点参数距返回0－>Success；非0状态码－值>Fail1.打印机行间距缺省设置为8。附加说明2.仅在一行开始处理时，该命令才有效。3.点距是指打印的内容每个点之间的距离。页脚内容19下载jre时出现的几个常见问题10)设置字符间距方法设置打印机字符串的字符间距为n个水平点距描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetWordSpacingByDotPitch(intn)方法名属性变量名类型变量含备注称义nintint入口水平点取值范围：0≤n≤255参数距返回0－>Success；非0状态码－值>Fail附加1.打印机字符间距缺省设置为0。说明2.在倍宽模式下，字符右侧间距是正常值的两倍。当字符被放大时，字符右侧间距被放大同样的倍数。该函数同时影响英文和汉字字符的设定。3.点距是指打印的内容每个点之间的距离。页脚内容20下载jre时出现的几个常见问题11)设置打印方向方法设置打印机字符串的打印方向描述com.cmcc.nativepackage.Printer包名+类名方法publicstaticnativeintsetPrintOrientation(intprintOrientation)名属性变量名类型变量含备注称义n打印方0：竖打printOr入口参数向ientation1：横打int0－>Success；返回值非0状态码－>Fail1.打印机缺省设置为横打。附加说明2.设置打印方向后，所有的打印都按照此格式打印。页脚内容21下载jre时出现的几个常见问题3.竖向不支持设置对齐方式，默认上对齐。12)设置/取消粗体打印方法设置打印机字符串是否粗体打印描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintsetBold(intn)方法名属性变量名类型变量含是否粗备注称义体0：取消粗体打印nint入口参数设置；1：设置粗体打印int0－>Success；返回值非0状态码－>Fail页脚内容22下载jre时出现的几个常见问题打印机缺省设置为非粗体打印。附加说明13)设置划线打印/取消下方法包名+方法属性入口设置打印机字符串是否下划线打印描述类名名com.cmcc.nativepackage.PrinterpublicstaticnativeintsetUnderLine(intn)变量名类型变量含备注称义nint是否下0：取消下划线打参数划线打印印；1：设置下划线打印返回int0－>Success；非0状态码－>值Fail页脚内容23下载jre时出现的几个常见问题附加打印机缺省设置为非下划线打印。说明14)设置/取消反白打印方法包名+方法属性入口设置打印机字符串是否反白打印com.cmcc.nativepackage.Printer描述类名名publicstaticnativeintsetInverse(intn)变量名类型变量含是否反备注称义nintint0：取消反白打参数白打印印；1：设置反白打印0－>Success；返回值非0状态码－>Fail页脚内容24下载jre时出现的几个常见问题附加打印机缺省设置为非反白打印。说明15)打印字符串方法描述打印字符串com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintprint(Stringcontent)方法名属性变量名类型变量含备注称义contentString打印字入口打印字符串，可参数符串包括多行打印数据，使用”\n”表示换行。int0－>Success；返回值非0状态码－>Fail附加当每行数据超出打印纸张宽度时打印机输出自动换行。说明页脚内容25下载jre时出现的几个常见问题16)打印HTML格式数据方法打印HTML格式数据描述com.cmcc.nativepackage.Printer包名+类名publicstaticnativeintprintHTML(Stringcontent)方法名属性变量名类型变量含备注称义contentStringintHTML格入口参数式数据返回0－>Success；非0状态码－值>Failhtml标签。附加支持常用说明页脚内容26下载jre时出现的几个常见问题5.3调用过程热敏打印机智能终端版CRM客户端1.加载组件2.调用组件:建立连接3.调用组件：初始化打印机函数4.调用组件：设置打印参数集函数5.调用组件：打印函数6.打印票据7.调用组件：关闭连接图1打印流程加载组件，调用加载外设组件流程。1、2、建立与热敏打印机的连接。3、调用组件的初始化打印机方法。调用组件的设置打印机参数方法集，如设置对齐方式、设置行间4、距等方法。调用组件的打印字符或打印HTML格式数据方法。5、6、打印机打印票据。页脚内容27下载jre时出现的几个常见问题关闭连接。7.6.二代证身份识别设备功能域接口6.1组件名称CMCC_IDCARD_厂家英文名缩写_厂家设备型号缩写.so6.2函数说明1)连接二代证身份识别设备方法包名+方法属性入口连接二代证身份识别设备描述com.cmcc.nativepackage.IDCard类名名publicstaticnativeintopenIDCard(intidCardType,StringdeviceId,Stringpassword)变量名类型变量含备注称义idCardTint二代证idCardTypeype参数身份识别设备类型1：USB二代证身份识别设备(包括USB智能终端外设一体机中的二代证身份识别页脚内容28下载jre时出现的几个常见问题设备)2：蓝牙二代证身份识别设备（包括蓝牙智能终端外设一体机中的二代证身份识别设备）3：串口二代证身份识别设备（包括串口智能终端外设一体机中的二代证身份识别设备）4、内置二代证身份识别设备（包括智能终端一体机中的二代证身份识别设备）deviceIString设备ID当idCardType为入口d2时参数deviceId为蓝牙二代证身份识别设备MAC地址当idCardType为3时deviceId为USB卡(线)转换的串口，如/dev/ttyUSB0。页脚内容29下载jre时出现的几个常见问题passwoStringint密码预留字段入口rd参数返回0－>Success；非0状态码－值>Failpassword是为了将来可能出现的wifi设备预留的参数。附加说明2)关闭二代证身份识别设备方法包名+方法属性关闭与二代证身份识别设备的连接描述com.cmcc.nativepackage.IDCard类名名publicstaticnativeintcloseIDCard()变量名类型变量含备注称义返回int0－>Success；非0状态码－值>页脚内容30下载jre时出现的几个常见问题Fail附加无说明3)获取组件版本信息方法获取各厂商二代证身份识别设备组件的版本信息。描述com.cmcc.nativepackage.IDCard包名+类名publicstaticnativeintgetIDCardVersion(byte[]version)方法名属性称变量名类型变量含备注义versionbyte[]版本号各厂商二代证身出口参数份识别设备组件的版本号(三位整数)，数值越大代表版本越高。返回int0－>Success；值非0状态码－>Fail页脚内容31下载jre时出现的几个常见问题附加无说明4)初始化二代证身份识别设备方法初始化二代证身份识别设备，清除二代证身份识别设备内描述缓存数据。com.cmcc.nativepackage.IDCard包名+类名publicstaticnativeintinitialIDCard()方法名属性称变量名类型变量含备注义int0－>Success；返回值非0状态码－>Fail附加无说明页脚内容32下载jre时出现的几个常见问题5)获得二代证信息方法获得二代证信息描述com.cmcc.nativepackage.IDCard包名+类名publicstaticnativeintgetIdCardInfo(String[]idCardInfo,byte[]img)方法名属性变量名类型变量含备注称义idCardIString[]二代证9，数组长度为出口nfo参数基本信息内容按顺序分别为：姓名、性别、民族、出生年月、地址、公民身份号码、签发机关、有效期限，照片保存地址。imgbyte[]int照片文出口证件头像图片参数件内容BASE64编码返回0－>Success；非0状态码－>值Fail页脚内容33下载jre时出现的几个常见问题附加无说明6.3调用过程智能终端版CRM客户端二代证身份识别设备1.加载组件2.调用组件：建立连接3.调用组件：初始化4.调用组件：获取二代身份证信息5.显示二代身份证信息6.调用组件：关闭连接图2二代证身份识别流程图示加载组件，调用加载外设组件流程。1、2、建立与二代证身份识别设备的连接。页脚内容34下载jre时出现的几个常见问题调用组件的初始化二代证身份识别设备方法。3、4、调用组件的获取二代证信息方法。5、页面显示二代证身份信息。6、关闭连接。7.写卡器设备功能域接口7.1组件名称CMCC_SIMCARD_厂家英文名缩写_厂家设备型号缩写.so7.2函数说明1)获取版本信息方法包名+方法属性通过该函数获取统一写卡组件的版本信息。描述com.cmcc.nativepackage.SimCard类名名publicstaticnativeintGetOPSVersion(char[]Version)变量名类型变量含备注称义页脚内容35下载jre时出现的几个常见问题Versionchar[]int版本号方法返回，统一出口参数写卡组件版本信息返回0－>Success；值非0状态码－>Fail附加无说明2)读空卡序列号方法该函数用于读取卡片空卡序列号，该函数支持本标准发布描述前和发布后的所有现场写卡系统空卡。因此CRM客户端可通过调用GetCardSN判断是否为本标准发布后生产的空卡。com.cmcc.nativepackage.SimCard包名+类名名publicstaticnativeintGetCardSN(char[]CardSN)方法属性称变量名类型变量含备注义出口CardSNchar[]空卡序空卡序列号，如卡片符合中国移动页脚内容36下载jre时出现的几个常见问题参数列号《SIM卡远程写卡业v1.0.0版本，16位，如卡务规范》则长度为片符合中国移动《现场写卡技术规范》，则长度为20位。返回int0－>Success；非0状态码－值>Fail附加无说明3)读取卡片信息方法该函数用于读取卡片信息，卡片信息包含卡片、卡片空ICCID描述卡序列号.com.cmcc.nativepackage.SimCard包名+类名publicstaticnativeintGetCardInfo(char[]CardInfo)方法名属性称变量名类型变量含备注义页脚内容37下载jre时出现的几个常见问题CardInfchar[]该参数该参数包含卡片出口o参数包含卡片ICCID、卡片ICCID、卡片空卡序列空号。格式为TLV格式，卡序列号具体参见格式《NGBOSS2-CRM(V45)(U)SIM卡写卡技术规【iccid+（iccid+...）+空卡序列号】范支撑分册20130722.doc》第8.3.3节。其中卡片ICCID如果为一卡多号卡，可出现多次。具体请参见《NGBOSS2-CRM(V45)(U)SIM卡写卡技术规范支撑分册20130722.doc》第7.7一卡多号卡写卡及第8.2.1节空卡判断。返回值int0－>Success；非0状态码－>Fail附加说明无页脚内容38下载jre时出现的几个常见问题4)实时写卡数据写入方法该函数用于实时写卡数据写入。函数返回值为时表示统一0描述写卡组件向卡片发送写卡数据成功并得到卡片响应。写卡是否成功须根据Result判断.com.cmcc.nativepackage.SimCard包名+类名publicstaticnativeintWriteCard(char[]IssueData,char[]Result)方法名属性变量名类型变量含备注称义IssueDachar[]现场写现场写卡系统生入口ta参数卡系统生成成的写卡下行报文，的写卡下行如多条报文，用“|”报文分隔。Resultchar[]卡片返卡片返回结果，出口参数回结果格式参见《NGBOSS2-CRM(V45)(U)SIM卡写卡技术规范支撑分册20130722.doc》第页脚内容39下载jre时出现的几个常见问题节中第3部分“返回数据格式”说明。CRM向现场写卡系统回传写卡结果时须传带MAC值的完整结果。返回附加int0－>Success；值非0状态码－>Fail无说明5)获取错误信息方法该函数用于获取错误信息，统一写卡组件将返回最近一次描述函数调用的错误信息。com.cmcc.nativepackage.SimCard包名+类名publicstaticnativeintGetOPSErrorMsg(intErrorCode,char[]方法ErrorMsg)名页脚内容40下载jre时出现的几个常见问题属性变量名类型变量含备注称义ErrorCoint最近一该参数为统一写出口de参数次接口调用卡组件最近一次接口的错误代码调用的错误代码，如最近一次执行成功则该参数返回0。ErrorMschar[]最近一该参数为统一写出口g参数次接口调用卡组件最近一次接口的错误描述调用的错误描述，如最近一次执行成功则该参数返回字符串“NoError”。返回int0－>Success；值非0状态码－>Fail附加无说明页脚内容41下载jre时出现的几个常见问题6)获取读卡器信息方法通过该函数连接读卡器。描述com.cmcc.nativepackage.SimCard包名+类名publicstaticnativeintConfigReader(intReaderType,char[]方法DeviceID,char[]Password)名属性变量名类型变量含备注称义Readerint入口读卡器1、USB口读卡器Type参数类型（CM-READER协议）；2、蓝牙读卡器；3、串口读卡器；4、内置读卡器DeviceIchar[]设备号入口1.ReaderType为1D参数时取值如下：WINDOWS:PCSC读卡器名称,Linux:PCSC读卡Android:USB读卡器VID+PID的16进器名称页脚内容42下载jre时出现的几个常见问题制字符串，如VID为23D8，PID为0185，则值为23D801852.ReaderType为2时为蓝牙读卡器MAC地址的16进制字符串,如读卡器MAC地址为11:22:33:44:55:，66则值为112233445566。3.ReaderType为3时取值如下：WINDOWS:串口名称，如COM1Linux:终端主机自带的串口，如/dev/ttyS0USB卡(线)转换的串口，如/dev/ttyUSB0Android:终端主机自带的串口，如/dev/ttyS0USB卡(线)转换的串口，如/dev/ttyUSB0页脚内容43下载jre时出现的几个常见问题4.ReaderType为4时取值如下：可以设置为固定值，也可以不配置Passwochar[]蓝牙读蓝牙读卡器连接入口rd参数卡器连接密密码，该字段为预留码字段。int0－>Success；返回值非0状态码－>Fail附加说明无7.3调用过程读卡页脚内容44下载jre时出现的几个常见问题智能终端版CRM客户端写卡器1.加载外设组件2.加载读卡器控制组件3.加载统一写卡组件4.调用外设组件读卡5.返回读卡结果图3读卡流程图加载组件，调用加载外设组件流程。1、2、通过外设组件相关函数调用统一写卡组件各函数进行读卡。显示读卡结果。3、写卡页脚内容45下载jre时出现的几个常见问题智能终端版CRM客户端写卡器1.加载外设组件1.加载读卡器控制组件2.加载统一写卡组件3.调用外设组件写卡4.返回写卡结果图4写卡流程图1、加载组件，调用加载外设组件流程。2、通过外设组件相关函数调用统一写卡组件各函数进行写卡，具体步骤请参见《中国移动现场写卡技术规范2.0》。3、显示写卡结果。8.银行卡读卡器设备功能域接口8.1组件名称CMCC_BANKCARD_厂家英文名缩写_厂家设备型号缩写.so页脚内容46下载jre时出现的几个常见问题8.2函数说明1)连接银行卡读卡器设备方法连接银行卡读卡器设备描述com.cmcc.nativepackage.BankCard包名+类名publicstaticnativeintopenBankCard(intbankCardType,String方法deviceId,Stringpassword)名属性变量名类型变量含备注称义bankCaint银行卡bankCardType入口rdType参数读卡器设备类型1：USB银行卡读(包括USB智能终端外设一体机中卡器设备的银行卡读卡器设备)2：蓝牙银行卡读卡器设备（包括蓝牙智能终端外设一体机中的银行卡读卡器设备）3：串口银行卡读卡器设备（包括串口页脚内容47下载jre时出现的几个常见问题智能终端外设一体机中的银行卡读卡器设备）4、内置银行卡读卡器设备（包括智能终端一体机中的银行卡读卡器设备）deviceIStrin