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

1、精選文庫(kù) 智能終端接口規(guī)范 版本號(hào)1.0 福建三元達(dá)軟件有限公司 二O四年六月 文檔變更說(shuō)明 版本 編號(hào) 變更 類(lèi)型 簡(jiǎn)要說(shuō)明（變更內(nèi)容和變更范圍） 日期 變更人 V1.0 新建 創(chuàng)建并擬制初稿 2014/6/24 朱有文 變更類(lèi)型：新建，修改，增加，刪除 精選文庫(kù) 目 錄 1. 前言 4 2. 目的范圍 5 3. 原則 5 4. 術(shù)語(yǔ)及縮略語(yǔ) 5 5. 寫(xiě)卡器設(shè)備功能域接口 6 5.1組件名稱(chēng) 6 5.2函數(shù)說(shuō)明 6 5.3調(diào)用過(guò)程 14 6. 二代證身份識(shí)別設(shè)備功能域接口. 14 6.1組件名稱(chēng) 14 6.2函數(shù)說(shuō)明 15 6.3調(diào)用過(guò)程 18 7. 寫(xiě)卡器設(shè)備功能域接口 18 7.1組件

2、名稱(chēng) 18 7.2函數(shù)說(shuō)明 19 7.3調(diào)用過(guò)程 23 8. 銀行卡讀卡器設(shè)備功能域接口 24 8.1組件名稱(chēng) 24 8.2函數(shù)說(shuō)明 24 8.3調(diào)用過(guò)程 27 9. 一體機(jī)組件名稱(chēng) 28 10. 一體機(jī)接口規(guī)范 28 1)一體機(jī)二代證讀卡 28 2) 一體機(jī)SIM卡讀寫(xiě)卡 28 3)一體機(jī)打印機(jī) 28 精選文庫(kù) 1. 前 言 近幾年，隨著An droid、iOS等智能終端操作系統(tǒng)的推廣，智能終端功能越來(lái)越豐富，越來(lái) 越被大眾所接受，移動(dòng)互聯(lián)網(wǎng)正欣欣向榮。智能終端具有體積小、攜帶方便、移動(dòng)辦公等優(yōu)勢(shì)。 移動(dòng)順應(yīng)時(shí)代潮流， 利用移動(dòng)互聯(lián)網(wǎng)新技術(shù)， 采取更為積極主動(dòng)的營(yíng)銷(xiāo)和服務(wù)模式， 也建立了包

3、括智能終端版 CRM 等移動(dòng)應(yīng)用，完善了自身的運(yùn)營(yíng)支撐能力，以適應(yīng)市場(chǎng)的需要，提升了自身 競(jìng)爭(zhēng)力，保持自身的行業(yè)優(yōu)勢(shì)。 移動(dòng)智能終端應(yīng)用在業(yè)務(wù)辦理過(guò)程中， 使用到了多種多樣的外接設(shè)備輔助辦公， 如藍(lán)牙打印 機(jī)、藍(lán)牙二代證讀卡器、藍(lán)牙 SIM 信息讀卡器等，為企業(yè)辦公、客戶帶來(lái)的極大的方便。與此同 時(shí)也帶來(lái)了問(wèn)題， 同種設(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)用。 2. 目的范圍 智能終端

4、外設(shè)接口規(guī)范適用于指導(dǎo)各外設(shè)廠家將其外設(shè)按照規(guī)范合理、 高效、快速地接入移 動(dòng)智能終端應(yīng)用， 是各外設(shè)廠家接入移動(dòng)智能終端應(yīng)用的主要依據(jù)。 本規(guī)范規(guī)定了外設(shè)的技術(shù)規(guī) 范、業(yè)務(wù)功能，操作流程。 3. 原則 本規(guī)范盡可能依據(jù)現(xiàn)有外設(shè)的行業(yè)技術(shù)規(guī)范，并能盡量最大化兼容各外設(shè)廠商。 4. 術(shù)語(yǔ)及縮略語(yǔ) 下列術(shù)語(yǔ)和縮略語(yǔ)適用于本規(guī)范： Android 是一種以 Linux 為基礎(chǔ)的開(kāi)放源碼操作系統(tǒng)，主要使用于便攜設(shè)備。 iOS 客戶 藍(lán)牙 用戶 iOS是由蘋(píng)果公司開(kāi)發(fā)的手持設(shè)備操作系統(tǒng)。 iOS與蘋(píng)果的Mac OS X操作 系統(tǒng)一樣，它也是以Darwin為基礎(chǔ)的，因此同樣屬于類(lèi) Unix的商業(yè)操作 系統(tǒng)

5、。 是指一個(gè)正在使用及可能使用移動(dòng)（包括第三方合作伙伴）提供的產(chǎn)品和 服務(wù)的個(gè)人、企業(yè)或者其他團(tuán)體。 是一種支持設(shè)備短距離通信（一般 10m內(nèi)）的無(wú)線電技術(shù)。能在包括移動(dòng)電 話、PDA無(wú)線耳機(jī)、筆記本電腦、相關(guān)外設(shè)等眾多設(shè)備之間進(jìn)行無(wú)線信息 交換。 用戶是移動(dòng)客戶訂購(gòu)產(chǎn)品的實(shí)例。包括資源占用、用戶價(jià)值、訂購(gòu)信息。 智能終端 二代證 是指像個(gè)人電腦一樣， 具有獨(dú)立的操作系統(tǒng)， 可以由用戶自行安裝軟件、 游戲等第三方服務(wù)商提供的程序， 通過(guò)此類(lèi)程序來(lái)不斷對(duì)終端的功能進(jìn) 行擴(kuò)充， 并可以通過(guò)移動(dòng)通訊網(wǎng)絡(luò)來(lái)實(shí)現(xiàn)無(wú)線網(wǎng)絡(luò)接入的這樣一類(lèi)終端 的總稱(chēng)。 第二代居民身份證 CRM 客戶關(guān)系管理 (Custom

6、er Relationship Management) SIM 用戶識(shí)別卡( Subscriber Identity Module ) 5. 寫(xiě)卡器設(shè)備功能域接口 5.1組件名稱(chēng) CMCC_PRINT廠家英文名縮寫(xiě)_廠家設(shè)備型號(hào)縮寫(xiě).so 5.2函數(shù)說(shuō)明 1）連接打印機(jī) 方法描述 連接打印機(jī) 包名+類(lèi)名 方法名 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) prin terT ype int 打印機(jī)類(lèi)型 prin terT ype com.cmcc. native package .Prin ter p ublic static n ative int openPrin ter(i nt p

7、rin terT yp e,Stri ng deviceldStri ng p assword) 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ī)） 入口參數(shù) deviceId Stri ng 設(shè)備ID 當(dāng) printerType為 2 時(shí), deviceId 為打印機(jī)MAC 地址。 當(dāng) printerType為 3 時(shí), deviceId 為 USB 卡(線) 轉(zhuǎn)換的串口，如 /dev/ttyUSBO 。 入

8、口參數(shù) P assword Stri ng 密碼 預(yù)留字段 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 Password是為了將來(lái)可能出現(xiàn)的 wifi設(shè)備預(yù)留的參數(shù)。 2）關(guān)閉打印機(jī) 方法描述 關(guān)閉與打印機(jī)的連接 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 p ublic static n ative int close Prin ter() 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 3）獲取組件版本信息 方法描述 獲取各廠商打印機(jī)組件的版本信息。

9、 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 p ublic static n ative int get Prin terVers ion( byte version) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) version byte 版本號(hào) 各廠商打印機(jī)組件的版 本號(hào)（三位整數(shù)），數(shù)值 越大代表版本越高。 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 4）初始化打印機(jī) 方法描述 初始化打印機(jī)，清除打印緩沖區(qū)中的數(shù)據(jù)，復(fù)位打印機(jī)打印參數(shù)到打印 機(jī)缺省參數(shù)。 包名+類(lèi)名 com.cmcc. native pac

10、kage .Prin ter 方法名 p ublic static n ative int in itia IPrin ter() 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 返回值 int 0- Success ； 非0狀態(tài)碼 Fail 附加說(shuō)明 不是完全恢復(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. 非下劃線打??；

11、10. 非反白打印。 5）設(shè)置字體寬高縮放比例 方法描述 設(shè)置打印機(jī)字符串的字符寬高縮放比例。 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int setZoonin(int widthZoonin,int heightZoonin) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) widthZo onin int 字體放大寬度 相比正常字體寬度的倍 數(shù)，必須是正整數(shù) 入口參數(shù) heightZo onl n int 字體放大高度 相比正常字體高度的倍 數(shù)，必須是正整數(shù)。 返回值 int 0 Success

12、； 非0狀態(tài)碼 Fail 附加說(shuō)明 打印機(jī)字體寬咼縮放比例缺省設(shè)置為1。 廠商必須支持寬咼縮放比為正常字體兩倍或以上。 精選文庫(kù) 6）設(shè)置對(duì)齊方式 方法描述 設(shè)置打印機(jī)字符串的對(duì)齊方式。 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int setAlignType(int alignType) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) alig nType int 對(duì)齊方式 0:左對(duì)齊； 1：居中對(duì)齊； 2:右對(duì)齊 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 打印機(jī)

13、缺省設(shè)置為左對(duì)齊。 2. 僅在一行開(kāi)始處理時(shí)，該命令才有效。 3. 豎向打印不支持設(shè)置對(duì)齊方式，默認(rèn)上對(duì)齊。 7）設(shè)置左邊距 方法描述 設(shè)置打印機(jī)每行字符左邊距為n個(gè)點(diǎn)距 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int setLeftMargin(int n) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n int 左邊點(diǎn)距 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 左邊距位置表示打印內(nèi)容的左側(cè)邊緣位置。 2. 點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。 8）設(shè)置右邊距

14、 方法描述 設(shè)置打印機(jī)每行字符右邊距為n個(gè)點(diǎn)距 方法名public static native int setRightMargin(int n) 包名+類(lèi)名 com.cmcc. native package .Prin ter 精選文庫(kù) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n int 右邊點(diǎn)距 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 右邊距位置表示打印內(nèi)容的右側(cè)邊緣位置。 2. 點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。 9) 設(shè)置行間距 方法描述 設(shè)置打印機(jī)字符串的字符行間距為n個(gè)垂直點(diǎn)距 包名+類(lèi)名 com.cmcc. native pack

15、age .Prin ter 方法名 public static native int setLineSpacingByDotPitch (int n) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n int 垂直點(diǎn)距 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 打印機(jī)行間距缺省設(shè)置為 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 打印機(jī)字符間距缺省設(shè)置為0。 2. 在倍寬模式下，字符右側(cè)間距是正常值的兩倍。當(dāng)字符被放大時(shí)，字 符右側(cè)間距被放大同樣的倍數(shù)。該函數(shù)同時(shí)影響英文和漢字字符的設(shè)定。 3.點(diǎn)距是指打印的內(nèi)容每個(gè)點(diǎn)之間的距離。 11) 設(shè)置打印方向 方法描述

16、設(shè)置打印機(jī)字符串的打印方向 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 p ublic static n ativeintset Prin tOrie ntati on(intprin tOrie ntati on) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n prin tOrie nt ation 打印方向 0:豎打 1：橫打 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 1. 打印機(jī)缺省設(shè)置為橫打。 2. 設(shè)置打印方向后，所有的打印都按照此格式打印。 3. 豎向不支持設(shè)置對(duì)齊方式，默認(rèn)上對(duì)齊。 12) 設(shè)置/

17、取消粗體打印 方法描述 設(shè)置打印機(jī)字符串是否粗體打印 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 p ublic static n ativeint setBold(i nt n) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n int 是否粗體 0:取消粗體打印設(shè)置； 1:設(shè)置粗體打印 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 打印機(jī)缺省設(shè)置為非粗體打印。 13) 設(shè)置/取消下劃線打印 方法描述 設(shè)置打印機(jī)字符串是否下劃線打印 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法

18、名 p ublic static n ative int set Un derL in e(i nt n) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) n int 是否下劃線打 印 0:取消下劃線打??； 1:設(shè)置下劃線打印 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 打印機(jī)缺省設(shè)置為非下劃線打印。 14) 設(shè)置/取消反白打印 方法描述 設(shè)置打印機(jī)字符串是否反白打印 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int setInverse(int n) 屬性 變量名稱(chēng) 類(lèi)型

19、變量含義 備注 入口參數(shù) n int 是否反白打印 0:取消反白打??； 1:設(shè)置反白打印 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 打印機(jī)缺省設(shè)置為非反白打印。 15) 打印字符串 方法描述 打印字符串 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int print(String content) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) content Stri ng 打印字符串 打印字符串，可包括多 行打印數(shù)據(jù)，使用”n ” 表示換行。 返回值 int 0 Succe

20、ss ; 非0狀態(tài)碼 Fail 附加說(shuō)明 當(dāng)每行數(shù)據(jù)超出打印紙張寬度時(shí)打印機(jī)輸出自動(dòng)換行。 16) 打印HTML格式數(shù)據(jù) 方法描述 打印HTML格式數(shù)據(jù) 包名+類(lèi)名 com.cmcc. native package .Prin ter 方法名 public static native int printHTML(String content) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) content Stri ng HTML格式數(shù)據(jù) 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 支持常用html 標(biāo)簽。 熱敏打印機(jī) 5.3調(diào)用過(guò)程 智能終端版CRM客戶端 1.加

21、載組件I 2.調(diào)用組件：建立連接 3.調(diào)用組件：初始化打印機(jī)函數(shù) *! I 4.調(diào)用組件：設(shè)置打印參數(shù)集函數(shù) 5.調(diào)用組件：打印函數(shù)I 7.調(diào)用組件：關(guān)閉連接 6.打印票據(jù) 圖1 打印流程 1、 加載組件，調(diào)用加載外設(shè)組件流程。 2、 建立與熱敏打印機(jī)的連接。 3、 調(diào)用組件的初始化打印機(jī)方法。 4、 調(diào)用組件的設(shè)置打印機(jī)參數(shù)方法集, 如設(shè)置對(duì)齊方式、設(shè)置行間距等方法。 5、 調(diào)用組件的打印字符或打印 HTML格式數(shù)據(jù)方法。 6、 打印機(jī)打印票據(jù)。 7. 關(guān)閉連接。 6. 二代證身份識(shí)別設(shè)備功能域接口 6.1組件名稱(chēng) CMCC_IDCARD廠家英文名縮寫(xiě)_廠家設(shè)備型號(hào)縮寫(xiě).so 6.2函數(shù)說(shuō)明

22、 1）連接二代證身份識(shí)別設(shè)備 方法描述 連接二代證身份識(shí)別設(shè)備 包名+類(lèi)名 方法名 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) idCardT ype int 二代證身份識(shí) idCardT ype 別設(shè)備類(lèi)型 1： USB二代證身份識(shí)別 com.cmcc. native package.lDCard public static native int openIDCard(int idCardType,String deviceId,Stri ng p assword) 設(shè)備（包括USB智能終端 外設(shè)一體機(jī)中的二代證 身份識(shí)別設(shè)備） 2:藍(lán)牙二代證身份識(shí)別 設(shè)備（包括藍(lán)牙智能終 端外設(shè)一體機(jī)

23、中的二代 證身份識(shí)別設(shè)備） 3:串口二代證身份識(shí)別 設(shè)備（包括串口智能終 端外設(shè)一體機(jī)中的二代 證身份識(shí)別設(shè)備） 4、內(nèi)置二代證身份識(shí)別 設(shè)備（包括智能終端, 體機(jī)中的二代證身份識(shí) 別設(shè)備） 入口參數(shù) deviceId Stri ng 設(shè)備ID 當(dāng) idCardType 為 2 時(shí) deviceId 為藍(lán)牙二代證 身份識(shí)別設(shè)備MAC地址 當(dāng) idCardType 為 3 時(shí) deviceId 為 USB 卡(線) 轉(zhuǎn)換的串口，如 /dev/ttyUSBO 。 入口參數(shù) P assword Stri ng 密碼 預(yù)留字段 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 P

24、assword是為了將來(lái)可能出現(xiàn)的 wifi設(shè)備預(yù)留的參數(shù)。 2）關(guān)閉二代證身份識(shí)別設(shè)備 方法描述 關(guān)閉與二代證身份識(shí)別設(shè)備的連接 包名+類(lèi)名 com.cmcc. native package.lDCard 方法名 public static native int closelDCard() 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 3）獲取組件版本信息 方法描述 獲取各廠商二代證身份識(shí)別設(shè)備組件的版本信息。 包名+類(lèi)名 com.cmcc. native package.lDCard 方法名 public static n

25、ative int getIDCardVersion(byte version) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) version byte 版本號(hào) 各廠商二代證身份識(shí)別 設(shè)備組件的版本號(hào)（三 位整數(shù)），數(shù)值越大代表 版本越高。 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 4）初始化二代證身份識(shí)別設(shè)備 方法描述 初始化二代證身份識(shí)別設(shè)備，清除二代證身份識(shí)別設(shè)備內(nèi)緩存數(shù)據(jù)。 包名+類(lèi)名 com.cmcc. native package.lDCard 方法名 public static native int initiallDCard () 屬性 變量

26、名稱(chēng) 類(lèi)型 變量含義 備注 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 5）獲得二代證信息 方法描述 獲得二代證信息 包名+類(lèi)名 com.cmcc. native package.lDCard 方法名 public static native int getIdCardInfo(String idCardInfo,byte img) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) idCardI nfo Strin g 二代證基本信 息 數(shù)組長(zhǎng)度為9,內(nèi)容按順 序分別為：姓名、性別、 民族、出生年月、地址、 公民身份號(hào)碼、簽發(fā)機(jī) 關(guān)、有效期限，照片保 存地址。

27、出口參數(shù) img byte 照片文件內(nèi)容 證件頭像圖片BASE64編 碼 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 6.3調(diào)用過(guò)程 智能終端版CRM客戶端 二代證身份識(shí)別設(shè)備 1.加載組件 2. 調(diào)用組件：建立連接 3. 調(diào)用組件：初始化 :I ! j5.顯示二代身份證信息 阡 6.調(diào)用組件：關(guān)閉連接 圖2 二代證身份識(shí)別流程圖示 1、 加載組件，調(diào)用加載外設(shè)組件流程。 2、 建立與二代證身份識(shí)別設(shè)備的連接。 3、 調(diào)用組件的初始化二代證身份識(shí)別設(shè)備方法。 4、 調(diào)用組件的獲取二代證信息方法。 5、 頁(yè)面顯示二代證身份信息。 6、 關(guān)閉連接。 7. 寫(xiě)卡器設(shè)備

28、功能域接口 7.1組件名稱(chēng) CMCC_SIMCARD廠家英文名縮寫(xiě)_廠家設(shè)備型號(hào)縮寫(xiě).so 7.2函數(shù)說(shuō)明 1）獲取版本信息 方法描述 通過(guò)該函數(shù)獲取統(tǒng)一寫(xiě)卡組件的版本信息。 包名+類(lèi)名 com.cmcc. native package.SimCard 方法名 public static native int GetOPSVersion( char Version) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) Versio n char 版本號(hào) 方法返回，統(tǒng)一寫(xiě)卡組 件版本信息 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 2）讀空卡序列號(hào) 方法描述 該函數(shù)用

29、于讀取卡片空卡序列號(hào)，該函數(shù)支持本標(biāo)準(zhǔn)發(fā)布前和發(fā)布后的所有 現(xiàn)場(chǎng)寫(xiě)卡系統(tǒng)空卡。因此CRM客戶端可通過(guò)調(diào)用 GetCardSN判斷是否為本標(biāo)準(zhǔn) 發(fā)布后生產(chǎn)的空卡。 包名+類(lèi)名 com.cmcc. native package.SimCard 方法名 p ublic static native int GetCardSN(char CardSN) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) CardSN char 空卡序列號(hào) 空卡序列號(hào)，如卡片符 合中國(guó)移動(dòng)SIM卡遠(yuǎn)程 寫(xiě)卡業(yè)務(wù)規(guī)范 v1.0.0 版本，則長(zhǎng)度為16位， 如卡片符合中國(guó)移動(dòng) 現(xiàn)場(chǎng)寫(xiě)卡技術(shù)規(guī)范， 則長(zhǎng)度為20位。 返回值 int

30、 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 3) 讀取卡片信息 方法描述 該函數(shù)用于讀取卡片信息，卡片信息包含卡片 ICCID、卡片空卡序列號(hào). 包名+類(lèi)名 方法名 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) CardI nfo char 該參數(shù)包含卡 片ICCID、卡片 空卡序列號(hào) 格式【iccid+ (iccid+. ) +空卡序列號(hào)】 該參數(shù)包含卡片 ICCID、卡片空卡序列 號(hào)。格式為T(mén)LV格式，具 體參見(jiàn) NGBOSS2-CRM(V4 5) (U)SIM卡寫(xiě)卡技術(shù)規(guī)范 支撐分冊(cè)20130722.doc 第8.3.3節(jié)。其中卡片 ICCID如果為一多號(hào) 卡，可出現(xiàn)

31、多次。具體 請(qǐng)參見(jiàn) NGBOSS2-CRM(V4 5) (U)SIM卡寫(xiě)卡技術(shù)規(guī)范 支撐分冊(cè)20130722.doc 第7.7 一卡多號(hào)卡寫(xiě)卡 及第8.2.1節(jié)空卡判斷。 返回值 int 0 Success ; 非0狀態(tài)碼 Fail com.cmcc. native package.SimCard p ublic static n ative int GetCard Info (char Cardinfo) 附加說(shuō)明 4) 實(shí)時(shí)寫(xiě)卡數(shù)據(jù)寫(xiě)入 方法描述 該函數(shù)用于實(shí)時(shí)寫(xiě)卡數(shù)據(jù)寫(xiě)入。函數(shù)返回值為0時(shí)表示統(tǒng)一寫(xiě)卡組件向卡片 發(fā)送寫(xiě)卡數(shù)據(jù)成功并得到卡片響應(yīng)。寫(xiě)卡是否成功須根據(jù)Result判斷. 包名+

32、類(lèi)名 com.cmcc. native package.SimCard 方法名 p ublic static n ative int WriteCard(char IssueData, char Result) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) IssueData char 現(xiàn)場(chǎng)寫(xiě)卡系統(tǒng) 生成的寫(xiě)卡下 行報(bào)文 現(xiàn)場(chǎng)寫(xiě)卡系統(tǒng)生成的寫(xiě) 卡下行報(bào)文，如多條報(bào) 文，用“ | ”分隔。 出口參數(shù) Result Cha叩 卡片返回結(jié)果 卡片返回結(jié)果，格式參見(jiàn) NGBOSS2-CRM(V4 5) (U)SIM卡寫(xiě)卡技術(shù)規(guī)范 支撐分冊(cè)20130722.doc 第833.2節(jié)中第3部分 “返回?cái)?shù)據(jù)

33、格式”說(shuō)明。 CRM向現(xiàn)場(chǎng)寫(xiě)卡系統(tǒng)回傳 寫(xiě)卡結(jié)果時(shí)須傳帶MA(值 的完整結(jié)果。 返回值 int 0- Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 5) 獲取錯(cuò)誤信息 方法描述 該函數(shù)用于獲取錯(cuò)誤信息，統(tǒng)一寫(xiě)卡組件將返回最近一次函數(shù)調(diào)用的錯(cuò) 誤信息。 包名+類(lèi)名 com.cmcc. native package.SimCard 方法名 p ublic static native int Get OP SErrorMsg(i nt ErrorCode, char ErrorMsg) 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 出口參數(shù) ErrorCode int 最近一次接口 調(diào)用的錯(cuò)誤代

34、碼 該參數(shù)為統(tǒng)一寫(xiě)卡組件 最近一次接口調(diào)用的錯(cuò) 誤代碼，如最近一次執(zhí)行 成功則該參數(shù)返回0。 出口參數(shù) ErrorMsg char 最近一次接口 調(diào)用的錯(cuò)誤描 述 該參數(shù)為統(tǒng)一寫(xiě)卡組件 最近一次接口調(diào)用的錯(cuò) 誤描述，如最近一次執(zhí)行 成功則該參數(shù)返回字符 串“ NoError ”。 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 6）獲取讀卡器信息 方法描述 通過(guò)該函數(shù)連接讀卡器。 包名+類(lèi)名 方法名 屬性 變量名稱(chēng) 類(lèi)型 變量含義 備注 入口參數(shù) ReaderT ype int 讀卡器類(lèi)型 1、 USB 口讀卡器 （cm-readER議）；2、 藍(lán)牙讀卡器；3、串口

35、讀 卡器；4、內(nèi)置讀卡器 入口參數(shù) DeviceID char 設(shè)備號(hào) 1.ReaderType 為 1 時(shí)取值 女口下：WINDOWS: P CS讀 卡器名稱(chēng),Linux: PCSC讀 卡器名稱(chēng)Android:USB讀 卡器VID+PID的16進(jìn)制字 符串，如 VID為23D8, PID 為 0185，則值為 23D80185 com.cmcc. native package.SimCard p ublic static n ative int Con figReader(i nt ReaderT ype, char DevicelD, char Password) 16進(jìn) MAC 為 ，則

36、 2. ReaderType 為 2 時(shí)為藍(lán) 牙讀卡器MAC地址的 制字符串，如讀卡器 地址 11:22:33:44:55:66 值為 112233445566。 3. ReaderType 為 3 時(shí)取值 如下：WINDOWS:串口名 稱(chēng)，女n COM1 Linux: 終 端主機(jī)自帶的串口，如 /dev/ttyS0 US味（線）轉(zhuǎn)換的串口, 如 /dev/ttyUSBO An droid:終端主機(jī)自 帶的串口， 如 /dev/ttyS0 US味（線）轉(zhuǎn)換的串口, 如 /dev/ttyUSB0 4. ReaderType 為 4 時(shí)取值 如下：可以設(shè)置為固定 值，也可以不配置 入口參數(shù) P assword Cha叩 藍(lán)牙讀卡器連 接密碼 藍(lán)牙讀卡器連接密碼，該 字段為預(yù)留字段。 返回值 int 0 Success ; 非0狀態(tài)碼 Fail 附加說(shuō)明 無(wú) 7.3調(diào)用過(guò)程 讀卡 智能終端版CRM客戶端 寫(xiě)卡器 |1.加載外設(shè)組件 2.加載讀卡器控制組件 I |3.加載統(tǒng)一寫(xiě)卡組件I I 4. 調(diào)用外設(shè)組件讀卡 I5.返回讀卡結(jié)果 !Success； 狀態(tài)碼 Fail 附加說(shuō)明 Password是為了將來(lái)可能岀現(xiàn)的wifi設(shè)備預(yù)留的參數(shù)。 2）關(guān)閉銀行卡讀卡器設(shè)備 方法描述 關(guān)閉與銀行卡讀卡器設(shè)備的連接 包名+類(lèi)名 com.cmcc .n ative pac