一體化終端設(shè)備技術(shù)規(guī)范

下載jre時(shí)出現(xiàn)的幾個(gè)常見問題智能終端接口規(guī)范版本號(hào)1.0福建三元達(dá)軟件有限公司二○一四年六月頁腳內(nèi)容1下載jre時(shí)出現(xiàn)的幾個(gè)常見問題文檔變更說明版變本編更類號(hào)型變簡要說明（變更內(nèi)容和變更范圍）日期更人V2014/新創(chuàng)建并擬制初稿朱1.06/24建有文頁腳內(nèi)容2下載jre時(shí)出現(xiàn)的幾個(gè)常見問題變更類型：新建，修改，增加，刪除頁腳內(nèi)容3下載jre時(shí)出現(xiàn)的幾個(gè)常見問題目錄1.前言圍則語口72.目的范83.原84.術(shù)語及縮略85.寫卡器設(shè)備功能域接95.1組件名稱.............................................................................................................................95.2函數(shù)說明.............................................................................................................................95.3調(diào)用過程...........................................................................................................................276.二代證身份識(shí)別設(shè)備功能域接口286.1組件名稱...........................................................................................................................28頁腳內(nèi)容4下載jre時(shí)出現(xiàn)的幾個(gè)常見問題6.2函數(shù)說明...........................................................................................................................286.3調(diào)用過程...........................................................................................................................347.寫卡器設(shè)備功能域接口357.1組件名稱7.2函數(shù)說明7.3調(diào)用過程8.銀行卡讀卡器設(shè)備功能域接口...........................................................................................................................35...........................................................................................................................35...........................................................................................................................44468.1組件名稱8.2函數(shù)說明8.3調(diào)用過程...........................................................................................................................46...........................................................................................................................47...........................................................................................................................539.一體機(jī)組件名稱5410.一體機(jī)接口規(guī)范......................................................................................................................541)一體機(jī)二代證讀卡542)一體機(jī)SIM卡讀寫卡54頁腳內(nèi)容5下載jre時(shí)出現(xiàn)的幾個(gè)常見問題3)一體機(jī)打印機(jī)54頁腳內(nèi)容6下載jre時(shí)出現(xiàn)的幾個(gè)常見問題1.前言近幾年，隨著Android、iOS等智能終端操作系統(tǒng)的推廣，智能終端功能越來越豐富，越來越被大眾所接受，移動(dòng)互聯(lián)網(wǎng)正欣欣向榮。智能終端具有體積小、攜帶方便、移動(dòng)辦公等優(yōu)勢。移動(dòng)順應(yīng)時(shí)代潮流，利用移動(dòng)互聯(lián)網(wǎng)新技術(shù)，采取更為積極主動(dòng)的營銷和服務(wù)模式，也建立了包括智能終端版CRM等移動(dòng)應(yīng)用，完善了自身的運(yùn)營支撐能力，以適應(yīng)市場的需要，提升了自身競爭力，保持自身的行業(yè)優(yōu)勢。移動(dòng)智能終端應(yīng)用在業(yè)務(wù)辦理過程中，使用到了多種多樣的外接設(shè)備輔助辦如藍(lán)牙打印機(jī)、藍(lán)牙二代證讀卡器、藍(lán)牙SIM信息讀卡器等，為企業(yè)辦公、客戶帶來的極大的方便。與此同時(shí)也帶來了問題，同種設(shè)備不同廠商在實(shí)現(xiàn)方式公，上各有差別，要兼容不同的外設(shè)廠商就必須付出等量的勞動(dòng)力。因此建立一套智能終端外設(shè)接口規(guī)范刻不容緩。智能終端外設(shè)接口規(guī)范明確了外設(shè)接入移動(dòng)智能終端應(yīng)用的技術(shù)規(guī)范、業(yè)務(wù)功能，以指導(dǎo)各外設(shè)廠家如何根據(jù)規(guī)范接入移動(dòng)智能終端應(yīng)用。頁腳內(nèi)容7下載jre時(shí)出現(xiàn)的幾個(gè)常見問題2.目的范圍智能終端外設(shè)接口規(guī)范適用于指導(dǎo)各外設(shè)廠家將其外設(shè)按照規(guī)范合理、高應(yīng)用的主要效、快速地接入移動(dòng)智能終端應(yīng)用，是各外設(shè)廠家接入移動(dòng)智能終端依據(jù)。本規(guī)范規(guī)定了外設(shè)的技術(shù)規(guī)范、業(yè)務(wù)功能，操作流程。3.原則本規(guī)范盡可能依據(jù)現(xiàn)有外設(shè)的行業(yè)技術(shù)規(guī)范，并能盡量最大化兼容各外設(shè)廠商。4.術(shù)語及縮略語下列術(shù)語和縮略語適用于本規(guī)范：AndroidiOS是一種以Linux為基礎(chǔ)的開放源碼操作系統(tǒng)，主要使用于便攜設(shè)備。iOS是由蘋果公司開發(fā)的手持設(shè)備操作系統(tǒng)。iOS與蘋果的MacOSX操作系統(tǒng)一樣，它也是以Darwin為基礎(chǔ)的于類Unix的商業(yè)操作系統(tǒng)。，因此同樣屬客戶是指一個(gè)正在使用及可能使用移動(dòng)（包括第三方合作伙伴）提供的產(chǎn)品和服務(wù)的個(gè)人、企業(yè)或者其他團(tuán)體。藍(lán)牙是一種支持設(shè)備短距離通信（一般10m內(nèi)）的無線電技術(shù)。能在包括移動(dòng)電話、PDA、無線耳機(jī)、筆記本電腦、相關(guān)外設(shè)頁腳內(nèi)容8下載jre時(shí)出現(xiàn)的幾個(gè)常見問題等眾多設(shè)備之間進(jìn)行無線信息交換。用戶用戶是移動(dòng)客戶訂購產(chǎn)品的實(shí)例。包括資源占用、用戶價(jià)值、訂購信息。智能終端是指像個(gè)人電腦一樣，具有獨(dú)立的操作系統(tǒng)，可以由用戶自行安裝軟件、游戲等第三方服務(wù)商提供的程序，通過此類程序來不斷對(duì)終端的功能進(jìn)行擴(kuò)充，并可以通過移動(dòng)通訊網(wǎng)絡(luò)來實(shí)現(xiàn)無線網(wǎng)絡(luò)接入的這樣一類終端的總稱。二代證CRM第二代居民身份證客戶關(guān)系管理(CustomerRelationshipManagement)用戶識(shí)別卡（SubscriberIdentityModule）SIM5.寫卡器設(shè)備功能域接口5.1組件名稱CMCC_PRINT_廠家英文名縮寫_廠家設(shè)備型號(hào)縮寫.so5.2函數(shù)說明1)連接打印機(jī)方法連接打印機(jī)頁腳內(nèi)容9下載jre時(shí)出現(xiàn)的幾個(gè)常見問題描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintopenPrinter(intprinterType,String方法deviceId,Stringpassword)名屬性變量名類型變量含備注稱義printerint打印機(jī)printerType入口Type參數(shù)類型1：USB打印機(jī)(包括USB智能終端外設(shè)一體機(jī)中的打印機(jī))2：藍(lán)牙打印機(jī)（包括藍(lán)牙智能終端外設(shè)一體機(jī)中的打印機(jī)）3：串口打印機(jī)（包括串口智能終端外設(shè)一體機(jī)中的打印機(jī)）4、內(nèi)置打印機(jī)（包括智能終端一體機(jī)中的打印機(jī)）入口deviceIString設(shè)備ID當(dāng)printerType為頁腳內(nèi)容10下載jre時(shí)出現(xiàn)的幾個(gè)常見問題參數(shù)d2時(shí)，deviceId為打印機(jī)MAC地址。當(dāng)printerType為3時(shí)，deviceId為USB卡(線)轉(zhuǎn)換的串口，如/dev/ttyUSB0。passwoStringint密碼預(yù)留字段入口rd參數(shù)0－>Success；非0狀態(tài)碼－>返回值Failpassword是為了將來可能出現(xiàn)的wifi設(shè)備預(yù)留的參數(shù)。附加說明2)關(guān)閉打印機(jī)方法關(guān)閉與打印機(jī)的連接描述類名名com.cmcc.nativepackage.Printer包名+方法publicstaticnativeintclosePrinter()頁腳內(nèi)容11下載jre時(shí)出現(xiàn)的幾個(gè)常見問題屬性變量名類型變量含備注稱義返回int0－>Success；值非0狀態(tài)碼－>Fail附加無說明3)獲取組件版本信息方法獲取各廠商打印機(jī)組件的版本信息。描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintgetPrinterVersion(byte[]version)方法名屬性變量名類型變量含備注稱義versionbyte[]版本號(hào)各廠商打印機(jī)組出口參數(shù)件的版本號(hào)(三位整數(shù))，數(shù)值越大代表版頁腳內(nèi)容12下載jre時(shí)出現(xiàn)的幾個(gè)常見問題本越高。int0－>Success；返回附加值非0狀態(tài)碼－>Fail無說明4)初始化打印機(jī)方法初始化打印機(jī)，清除打印緩沖區(qū)中的數(shù)據(jù)，復(fù)位打印機(jī)打描述印參數(shù)到打印機(jī)缺省參數(shù)。com.cmcc.nativepackage.Printer包名+方法屬性返回類名publicstaticnativeintinitialPrinter()名變量名類型變量含備注稱義int0－>Success；值非0狀態(tài)碼－>Fail頁腳內(nèi)容13下載jre時(shí)出現(xiàn)的幾個(gè)常見問題附加不是完全恢復(fù)到出廠設(shè)置，只是將打印指令參數(shù)恢復(fù)到打說明印機(jī)缺省參數(shù)。點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。具體缺省設(shè)置包括如下：1.字體寬高縮放比例：1；2.對(duì)齊方式：左對(duì)齊；3.左邊距：0個(gè)點(diǎn)距；4.右邊距:0個(gè)點(diǎn)距；5.行間距：8個(gè)點(diǎn)距；6.字符間距：0個(gè)點(diǎn)距；7.打印8.非粗體打印9.非下10.非反白打印方向：橫打；；劃線打??；。5)設(shè)置字體寬高縮放比例方法設(shè)置打印機(jī)字符串的字符寬高縮放比例。頁腳內(nèi)容14下載jre時(shí)出現(xiàn)的幾個(gè)常見問題描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetZoonIn(intwidthZoonIn,intheightZoonIn)方法名屬性變量名類型變量含備注稱義widthZintintint入口字體放相比正常字體寬oonIn參數(shù)參數(shù)大寬度度的倍數(shù)，必須是正整數(shù)heightZ入口字體放相比正常字體高oonIn大高度度的倍數(shù)，必須是正整數(shù)。0－>Success；返回值非0狀態(tài)碼－>Fail打印機(jī)字體寬高縮放比例缺省設(shè)置為1。附加說明廠商必須支持寬高縮放比為正常字體兩倍或以上。頁腳內(nèi)容15下載jre時(shí)出現(xiàn)的幾個(gè)常見問題6)設(shè)置對(duì)齊方式方法設(shè)置打印機(jī)字符串的對(duì)齊方式。描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetAlignType(intalignType)方法名屬性變量名類型變量含備注稱義alignTyintint對(duì)齊方0：左對(duì)齊；入口pe參數(shù)式1：居中對(duì)齊；2：右對(duì)齊返回0－>Success；值非0狀態(tài)碼－>Fail1.打印機(jī)缺省設(shè)置為左對(duì)齊。2.僅在一行開始處理時(shí)3.豎向打印附加說明，該命令才有效。不支持設(shè)置對(duì)齊方式，默認(rèn)上對(duì)齊。頁腳內(nèi)容16下載jre時(shí)出現(xiàn)的幾個(gè)常見問題7)設(shè)置左邊距方法設(shè)置打印機(jī)每行字符左邊距為n個(gè)點(diǎn)距描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetLeftMargin(intn)方法名屬性變量名類型變量含備注稱義nintint入口左邊點(diǎn)參數(shù)距返回0－>Success；值非0狀態(tài)碼－>Fail1.左邊距位置表示打印內(nèi)容的左側(cè)邊緣位置。附加說明2.點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。頁腳內(nèi)容17下載jre時(shí)出現(xiàn)的幾個(gè)常見問題8)設(shè)置右邊距方法設(shè)置打印機(jī)每行字符右邊距為n個(gè)點(diǎn)距描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetRightMargin(intn)方法名屬性變量名類型變量含備注稱義nintint右邊點(diǎn)入口參數(shù)距返回0－>Success；非0狀態(tài)碼－值>Fail1.右邊距位置表示打印內(nèi)容的右側(cè)邊緣位置。附加說明2.點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。頁腳內(nèi)容18下載jre時(shí)出現(xiàn)的幾個(gè)常見問題9)設(shè)置行間距方法設(shè)置打印機(jī)字符串的字符行間距為n個(gè)垂直點(diǎn)距描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetLineSpacingByDotPitch(intn)方法名屬性變量名類型變量含備注稱義nintint入口垂直點(diǎn)參數(shù)距返回0－>Success；非0狀態(tài)碼－值>Fail1.打印機(jī)行間距缺省設(shè)置為8。附加說明2.僅在一行開始處理時(shí)，該命令才有效。3.點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。頁腳內(nèi)容19下載jre時(shí)出現(xiàn)的幾個(gè)常見問題10)設(shè)置字符間距方法設(shè)置打印機(jī)字符串的字符間距為n個(gè)水平點(diǎn)距描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetWordSpacingByDotPitch(intn)方法名屬性變量名類型變量含備注稱義nintint入口水平點(diǎn)取值范圍：0≤n≤255參數(shù)距返回0－>Success；非0狀態(tài)碼－值>Fail附加1.打印機(jī)字符間距缺省設(shè)置為0。說明2.在倍寬模式下，字符右側(cè)間距是正常值的兩倍。當(dāng)字符被放大時(shí)，字符右側(cè)間距被放大同樣的倍數(shù)。該函數(shù)同時(shí)影響英文和漢字字符的設(shè)定。3.點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。頁腳內(nèi)容20下載jre時(shí)出現(xiàn)的幾個(gè)常見問題11)設(shè)置打印方向方法設(shè)置打印機(jī)字符串的打印方向描述com.cmcc.nativepackage.Printer包名+類名方法publicstaticnativeintsetPrintOrientation(intprintOrientation)名屬性變量名類型變量含備注稱義n打印方0：豎打printOr入口參數(shù)向ientation1：橫打int0－>Success；返回值非0狀態(tài)碼－>Fail1.打印機(jī)缺省設(shè)置為橫打。附加說明2.設(shè)置打印方向后，所有的打印都按照此格式打印。頁腳內(nèi)容21下載jre時(shí)出現(xiàn)的幾個(gè)常見問題3.豎向不支持設(shè)置對(duì)齊方式，默認(rèn)上對(duì)齊。12)設(shè)置/取消粗體打印方法設(shè)置打印機(jī)字符串是否粗體打印描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintsetBold(intn)方法名屬性變量名類型變量含是否粗備注稱義體0：取消粗體打印nint入口參數(shù)設(shè)置；1：設(shè)置粗體打印int0－>Success；返回值非0狀態(tài)碼－>Fail頁腳內(nèi)容22下載jre時(shí)出現(xiàn)的幾個(gè)常見問題打印機(jī)缺省設(shè)置為非粗體打印。附加說明13)設(shè)置劃線打印/取消下方法包名+方法屬性入口設(shè)置打印機(jī)字符串是否下劃線打印描述類名名com.cmcc.nativepackage.PrinterpublicstaticnativeintsetUnderLine(intn)變量名類型變量含備注稱義nint是否下0：取消下劃線打參數(shù)劃線打印??；1：設(shè)置下劃線打印返回int0－>Success；非0狀態(tài)碼－>值Fail頁腳內(nèi)容23下載jre時(shí)出現(xiàn)的幾個(gè)常見問題附加打印機(jī)缺省設(shè)置為非下劃線打印。說明14)設(shè)置/取消反白打印方法包名+方法屬性入口設(shè)置打印機(jī)字符串是否反白打印com.cmcc.nativepackage.Printer描述類名名publicstaticnativeintsetInverse(intn)變量名類型變量含是否反備注稱義nintint0：取消反白打參數(shù)白打印?。?：設(shè)置反白打印0－>Success；返回值非0狀態(tài)碼－>Fail頁腳內(nèi)容24下載jre時(shí)出現(xiàn)的幾個(gè)常見問題附加打印機(jī)缺省設(shè)置為非反白打印。說明15)打印字符串方法描述打印字符串com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintprint(Stringcontent)方法名屬性變量名類型變量含備注稱義contentString打印字入口打印字符串，可參數(shù)符串包括多行打印數(shù)據(jù)，使用”\n”表示換行。int0－>Success；返回值非0狀態(tài)碼－>Fail附加當(dāng)每行數(shù)據(jù)超出打印紙張寬度時(shí)打印機(jī)輸出自動(dòng)換行。說明頁腳內(nèi)容25下載jre時(shí)出現(xiàn)的幾個(gè)常見問題16)打印HTML格式數(shù)據(jù)方法打印HTML格式數(shù)據(jù)描述com.cmcc.nativepackage.Printer包名+類名publicstaticnativeintprintHTML(Stringcontent)方法名屬性變量名類型變量含備注稱義contentStringintHTML格入口參數(shù)式數(shù)據(jù)返回0－>Success；非0狀態(tài)碼－值>Failhtml標(biāo)簽。附加支持常用說明頁腳內(nèi)容26下載jre時(shí)出現(xiàn)的幾個(gè)常見問題5.3調(diào)用過程熱敏打印機(jī)智能終端版CRM客戶端1.加載組件2.調(diào)用組件:建立連接3.調(diào)用組件：初始化打印機(jī)函數(shù)4.調(diào)用組件：設(shè)置打印參數(shù)集函數(shù)5.調(diào)用組件：打印函數(shù)6.打印票據(jù)7.調(diào)用組件：關(guān)閉連接圖1打印流程加載組件，調(diào)用加載外設(shè)組件流程。1、2、建立與熱敏打印機(jī)的連接。3、調(diào)用組件的初始化打印機(jī)方法。調(diào)用組件的設(shè)置打印機(jī)參數(shù)方法集，如設(shè)置對(duì)齊方式、設(shè)置行間4、距等方法。調(diào)用組件的打印字符或打印HTML格式數(shù)據(jù)方法。5、6、打印機(jī)打印票據(jù)。頁腳內(nèi)容27下載jre時(shí)出現(xiàn)的幾個(gè)常見問題關(guān)閉連接。7.6.二代證身份識(shí)別設(shè)備功能域接口6.1組件名稱CMCC_IDCARD_廠家英文名縮寫_廠家設(shè)備型號(hào)縮寫.so6.2函數(shù)說明1)連接二代證身份識(shí)別設(shè)備方法包名+方法屬性入口連接二代證身份識(shí)別設(shè)備描述com.cmcc.nativepackage.IDCard類名名publicstaticnativeintopenIDCard(intidCardType,StringdeviceId,Stringpassword)變量名類型變量含備注稱義idCardTint二代證idCardTypeype參數(shù)身份識(shí)別設(shè)備類型1：USB二代證身份識(shí)別設(shè)備(包括USB智能終端外設(shè)一體機(jī)中的二代證身份識(shí)別頁腳內(nèi)容28下載jre時(shí)出現(xiàn)的幾個(gè)常見問題設(shè)備)2：藍(lán)牙二代證身份識(shí)別設(shè)備（包括藍(lán)牙智能終端外設(shè)一體機(jī)中的二代證身份識(shí)別設(shè)備）3：串口二代證身份識(shí)別設(shè)備（包括串口智能終端外設(shè)一體機(jī)中的二代證身份識(shí)別設(shè)備）4、內(nèi)置二代證身份識(shí)別設(shè)備（包括智能終端一體機(jī)中的二代證身份識(shí)別設(shè)備）deviceIString設(shè)備ID當(dāng)idCardType為入口d2時(shí)參數(shù)deviceId為藍(lán)牙二代證身份識(shí)別設(shè)備MAC地址當(dāng)idCardType為3時(shí)deviceId為USB卡(線)轉(zhuǎn)換的串口，如/dev/ttyUSB0。頁腳內(nèi)容29下載jre時(shí)出現(xiàn)的幾個(gè)常見問題passwoStringint密碼預(yù)留字段入口rd參數(shù)返回0－>Success；非0狀態(tài)碼－值>Failpassword是為了將來可能出現(xiàn)的wifi設(shè)備預(yù)留的參數(shù)。附加說明2)關(guān)閉二代證身份識(shí)別設(shè)備方法包名+方法屬性關(guān)閉與二代證身份識(shí)別設(shè)備的連接描述com.cmcc.nativepackage.IDCard類名名publicstaticnativeintcloseIDCard()變量名類型變量含備注稱義返回int0－>Success；非0狀態(tài)碼－值>頁腳內(nèi)容30下載jre時(shí)出現(xiàn)的幾個(gè)常見問題Fail附加無說明3)獲取組件版本信息方法獲取各廠商二代證身份識(shí)別設(shè)備組件的版本信息。描述com.cmcc.nativepackage.IDCard包名+類名publicstaticnativeintgetIDCardVersion(byte[]version)方法名屬性稱變量名類型變量含備注義versionbyte[]版本號(hào)各廠商二代證身出口參數(shù)份識(shí)別設(shè)備組件的版本號(hào)(三位整數(shù))，數(shù)值越大代表版本越高。返回int0－>Success；值非0狀態(tài)碼－>Fail頁腳內(nèi)容31下載jre時(shí)出現(xiàn)的幾個(gè)常見問題附加無說明4)初始化二代證身份識(shí)別設(shè)備方法初始化二代證身份識(shí)別設(shè)備，清除二代證身份識(shí)別設(shè)備內(nèi)描述緩存數(shù)據(jù)。com.cmcc.nativepackage.IDCard包名+類名publicstaticnativeintinitialIDCard()方法名屬性稱變量名類型變量含備注義int0－>Success；返回值非0狀態(tài)碼－>Fail附加無說明頁腳內(nèi)容32下載jre時(shí)出現(xiàn)的幾個(gè)常見問題5)獲得二代證信息方法獲得二代證信息描述com.cmcc.nativepackage.IDCard包名+類名publicstaticnativeintgetIdCardInfo(String[]idCardInfo,byte[]img)方法名屬性變量名類型變量含備注稱義idCardIString[]二代證9，數(shù)組長度為出口nfo參數(shù)基本信息內(nèi)容按順序分別為：姓名、性別、民族、出生年月、地址、公民身份號(hào)碼、簽發(fā)機(jī)關(guān)、有效期限，照片保存地址。imgbyte[]int照片文出口證件頭像圖片參數(shù)件內(nèi)容BASE64編碼返回0－>Success；非0狀態(tài)碼－>值Fail頁腳內(nèi)容33下載jre時(shí)出現(xiàn)的幾個(gè)常見問題附加無說明6.3調(diào)用過程智能終端版CRM客戶端二代證身份識(shí)別設(shè)備1.加載組件2.調(diào)用組件：建立連接3.調(diào)用組件：初始化4.調(diào)用組件：獲取二代身份證信息5.顯示二代身份證信息6.調(diào)用組件：關(guān)閉連接圖2二代證身份識(shí)別流程圖示加載組件，調(diào)用加載外設(shè)組件流程。1、2、建立與二代證身份識(shí)別設(shè)備的連接。頁腳內(nèi)容34下載jre時(shí)出現(xiàn)的幾個(gè)常見問題調(diào)用組件的初始化二代證身份識(shí)別設(shè)備方法。3、4、調(diào)用組件的獲取二代證信息方法。5、頁面顯示二代證身份信息。6、關(guān)閉連接。7.寫卡器設(shè)備功能域接口7.1組件名稱CMCC_SIMCARD_廠家英文名縮寫_廠家設(shè)備型號(hào)縮寫.so7.2函數(shù)說明1)獲取版本信息方法包名+方法屬性通過該函數(shù)獲取統(tǒng)一寫卡組件的版本信息。描述com.cmcc.nativepackage.SimCard類名名publicstaticnativeintGetOPSVersion(char[]Version)變量名類型變量含備注稱義頁腳內(nèi)容35下載jre時(shí)出現(xiàn)的幾個(gè)常見問題Versionchar[]int版本號(hào)方法返回，統(tǒng)一出口參數(shù)寫卡組件版本信息返回0－>Success；值非0狀態(tài)碼－>Fail附加無說明2)讀空卡序列號(hào)方法該函數(shù)用于讀取卡片空卡序列號(hào)，該函數(shù)支持本標(biāo)準(zhǔn)發(fā)布描述前和發(fā)布后的所有現(xiàn)場寫卡系統(tǒng)空卡。因此CRM客戶端可通過調(diào)用GetCardSN判斷是否為本標(biāo)準(zhǔn)發(fā)布后生產(chǎn)的空卡。com.cmcc.nativepackage.SimCard包名+類名名publicstaticnativeintGetCardSN(char[]CardSN)方法屬性稱變量名類型變量含備注義出口CardSNchar[]空卡序空卡序列號(hào)，如卡片符合中國移動(dòng)頁腳內(nèi)容36下載jre時(shí)出現(xiàn)的幾個(gè)常見問題參數(shù)列號(hào)《SIM卡遠(yuǎn)程寫卡業(yè)v1.0.0版本，16位，如卡務(wù)規(guī)范》則長度為片符合中國移動(dòng)《現(xiàn)場寫卡技術(shù)規(guī)范》，則長度為20位。返回int0－>Success；非0狀態(tài)碼－值>Fail附加無說明3)讀取卡片信息方法該函數(shù)用于讀取卡片信息，卡片信息包含卡片、卡片空ICCID描述卡序列號(hào).com.cmcc.nativepackage.SimCard包名+類名publicstaticnativeintGetCardInfo(char[]CardInfo)方法名屬性稱變量名類型變量含備注義頁腳內(nèi)容37下載jre時(shí)出現(xiàn)的幾個(gè)常見問題CardInfchar[]該參數(shù)該參數(shù)包含卡片出口o參數(shù)包含卡片ICCID、卡片ICCID、卡片空卡序列空號(hào)。格式為TLV格式，卡序列號(hào)具體參見格式《NGBOSS2-CRM(V45)(U)SIM卡寫卡技術(shù)規(guī)【iccid+（iccid+...）+空卡序列號(hào)】范支撐分冊20130722.doc》第8.3.3節(jié)。其中卡片ICCID如果為一卡多號(hào)卡，可出現(xiàn)多次。具體請(qǐng)參見《NGBOSS2-CRM(V45)(U)SIM卡寫卡技術(shù)規(guī)范支撐分冊20130722.doc》第7.7一卡多號(hào)卡寫卡及第8.2.1節(jié)空卡判斷。返回值int0－>Success；非0狀態(tài)碼－>Fail附加說明無頁腳內(nèi)容38下載jre時(shí)出現(xiàn)的幾個(gè)常見問題4)實(shí)時(shí)寫卡數(shù)據(jù)寫入方法該函數(shù)用于實(shí)時(shí)寫卡數(shù)據(jù)寫入。函數(shù)返回值為時(shí)表示統(tǒng)一0描述寫卡組件向卡片發(fā)送寫卡數(shù)據(jù)成功并得到卡片響應(yīng)。寫卡是否成功須根據(jù)Result判斷.com.cmcc.nativepackage.SimCard包名+類名publicstaticnativeintWriteCard(char[]IssueData,char[]Result)方法名屬性變量名類型變量含備注稱義IssueDachar[]現(xiàn)場寫現(xiàn)場寫卡系統(tǒng)生入口ta參數(shù)卡系統(tǒng)生成成的寫卡下行報(bào)文，的寫卡下行如多條報(bào)文，用“|”報(bào)文分隔。Resultchar[]卡片返卡片返回結(jié)果，出口參數(shù)回結(jié)果格式參見《NGBOSS2-CRM(V45)(U)SIM卡寫卡技術(shù)規(guī)范支撐分冊20130722.doc》第頁腳內(nèi)容39下載jre時(shí)出現(xiàn)的幾個(gè)常見問題節(jié)中第3部分“返回?cái)?shù)據(jù)格式”說明。CRM向現(xiàn)場寫卡系統(tǒng)回傳寫卡結(jié)果時(shí)須傳帶MAC值的完整結(jié)果。返回附加int0－>Success；值非0狀態(tài)碼－>Fail無說明5)獲取錯(cuò)誤信息方法該函數(shù)用于獲取錯(cuò)誤信息，統(tǒng)一寫卡組件將返回最近一次描述函數(shù)調(diào)用的錯(cuò)誤信息。com.cmcc.nativepackage.SimCard包名+類名publicstaticnativeintGetOPSErrorMsg(intErrorCode,char[]方法ErrorMsg)名頁腳內(nèi)容40下載jre時(shí)出現(xiàn)的幾個(gè)常見問題屬性變量名類型變量含備注稱義ErrorCoint最近一該參數(shù)為統(tǒng)一寫出口de參數(shù)次接口調(diào)用卡組件最近一次接口的錯(cuò)誤代碼調(diào)用的錯(cuò)誤代碼，如最近一次執(zhí)行成功則該參數(shù)返回0。ErrorMschar[]最近一該參數(shù)為統(tǒng)一寫出口g參數(shù)次接口調(diào)用卡組件最近一次接口的錯(cuò)誤描述調(diào)用的錯(cuò)誤描述，如最近一次執(zhí)行成功則該參數(shù)返回字符串“NoError”。返回int0－>Success；值非0狀態(tài)碼－>Fail附加無說明頁腳內(nèi)容41下載jre時(shí)出現(xiàn)的幾個(gè)常見問題6)獲取讀卡器信息方法通過該函數(shù)連接讀卡器。描述com.cmcc.nativepackage.SimCard包名+類名publicstaticnativeintConfigReader(intReaderType,char[]方法DeviceID,char[]Password)名屬性變量名類型變量含備注稱義Readerint入口讀卡器1、USB口讀卡器Type參數(shù)類型（CM-READER協(xié)議）；2、藍(lán)牙讀卡器；3、串口讀卡器；4、內(nèi)置讀卡器DeviceIchar[]設(shè)備號(hào)入口1.ReaderType為1D參數(shù)時(shí)取值如下：WINDOWS:PCSC讀卡器名稱,Linux:PCSC讀卡Android:USB讀卡器VID+PID的16進(jìn)器名稱頁腳內(nèi)容42下載jre時(shí)出現(xiàn)的幾個(gè)常見問題制字符串，如VID為23D8，PID為0185，則值為23D801852.ReaderType為2時(shí)為藍(lán)牙讀卡器MAC地址的16進(jìn)制字符串,如讀卡器MAC地址為11:22:33:44:55:，66則值為112233445566。3.ReaderType為3時(shí)取值如下：WINDOWS:串口名稱，如COM1Linux:終端主機(jī)自帶的串口，如/dev/ttyS0USB卡(線)轉(zhuǎn)換的串口，如/dev/ttyUSB0Android:終端主機(jī)自帶的串口，如/dev/ttyS0USB卡(線)轉(zhuǎn)換的串口，如/dev/ttyUSB0頁腳內(nèi)容43下載jre時(shí)出現(xiàn)的幾個(gè)常見問題4.ReaderType為4時(shí)取值如下：可以設(shè)置為固定值，也可以不配置Passwochar[]藍(lán)牙讀藍(lán)牙讀卡器連接入口rd參數(shù)卡器連接密密碼，該字段為預(yù)留碼字段。int0－>Success；返回值非0狀態(tài)碼－>Fail附加說明無7.3調(diào)用過程讀卡頁腳內(nèi)容44下載jre時(shí)出現(xiàn)的幾個(gè)常見問題智能終端版CRM客戶端寫卡器1.加載外設(shè)組件2.加載讀卡器控制組件3.加載統(tǒng)一寫卡組件4.調(diào)用外設(shè)組件讀卡5.返回讀卡結(jié)果圖3讀卡流程圖加載組件，調(diào)用加載外設(shè)組件流程。1、2、通過外設(shè)組件相關(guān)函數(shù)調(diào)用統(tǒng)一寫卡組件各函數(shù)進(jìn)行讀卡。顯示讀卡結(jié)果。3、寫卡頁腳內(nèi)容45下載jre時(shí)出現(xiàn)的幾個(gè)常見問題智能終端版CRM客戶端寫卡器1.加載外設(shè)組件1.加載讀卡器控制組件2.加載統(tǒng)一寫卡組件3.調(diào)用外設(shè)組件寫卡4.返回寫卡結(jié)果圖4寫卡流程圖1、加載組件，調(diào)用加載外設(shè)組件流程。2、通過外設(shè)組件相關(guān)函數(shù)調(diào)用統(tǒng)一寫卡組件各函數(shù)進(jìn)行寫卡，具體步驟請(qǐng)參見《中國移動(dòng)現(xiàn)場寫卡技術(shù)規(guī)范2.0》。3、顯示寫卡結(jié)果。8.銀行卡讀卡器設(shè)備功能域接口8.1組件名稱CMCC_BANKCARD_廠家英文名縮寫_廠家設(shè)備型號(hào)縮寫.so頁腳內(nèi)容46下載jre時(shí)出現(xiàn)的幾個(gè)常見問題8.2函數(shù)說明1)連接銀行卡讀卡器設(shè)備方法連接銀行卡讀卡器設(shè)備描述com.cmcc.nativepackage.BankCard包名+類名publicstaticnativeintopenBankCard(intbankCardType,String方法deviceId,Stringpassword)名屬性變量名類型變量含備注稱義bankCaint銀行卡bankCardType入口rdType參數(shù)讀卡器設(shè)備類型1：USB銀行卡讀(包括USB智能終端外設(shè)一體機(jī)中卡器設(shè)備的銀行卡讀卡器設(shè)備)2：藍(lán)牙銀行卡讀卡器設(shè)備（包括藍(lán)牙智能終端外設(shè)一體機(jī)中的銀行卡讀卡器設(shè)備）3：串口銀行卡讀卡器設(shè)備（包括串口頁腳內(nèi)容47下載jre時(shí)出現(xiàn)的幾個(gè)常見問題智能終端外設(shè)一體機(jī)中的銀行卡讀卡器設(shè)備）4、內(nèi)置銀行卡讀卡器設(shè)備（包括智能終端一體機(jī)中的銀行卡讀卡器設(shè)備）deviceIStrin