大街小巷隨處可見(jiàn)的支付寶蜻蜓設(shè)備，除了日常的支付收款之外，還可以通過(guò)集成身份證讀卡器適配，來(lái)實(shí)現(xiàn)人證核驗(yàn)，從而達(dá)到實(shí)名制場(chǎng)景需要的效果。
中軟高科出品的身份證讀卡器，不僅從顏色上和支付寶蜻蜓設(shè)備十分契合，而且還是支付寶蜻蜓設(shè)備支持的云讀卡器。
支付寶IoT小程序支持中軟高科云讀卡器
下面簡(jiǎn)要介紹一下支付寶IoT小程序集成身份證讀卡器適配的方法。
接口調(diào)用示例代碼.js 示例代碼設(shè)置云讀卡
my.ix.cardReaderCommand({cmds:{'cmd':'setConfigs','args':[{'server':'sunmi','appId':'f88548a4e6633266b11bc3019810c582'}]},success:(r)=>{this.setData({message:"設(shè)置成功-->"+JSON.stringify(r)
})
},fail:(r)=>{this.setData({message:"設(shè)置失敗-->"+JSON.stringify(r)
})
},
});讀卡
my.ix.cardReaderCommand({
cmds:{'cmd':'readCard','args':[]},
success:(r)=>{this.onCardInfo(r)
},
fail:(r)=>{this.setData({
message:"讀卡失敗-->"+JSON.stringify(r)
})
},
});入?yún)?span>名稱
類型
是否必填
描述
target
Number
否
要與之通信的讀卡器 id，通過(guò) my.ix.getDevices 獲得。如果不填，默認(rèn)系統(tǒng)接入的第 1 個(gè)讀卡器設(shè)備。
cmds
JSON
是
JSON 格式： {'cmd': '...', 'args': ['...']}
通信指令，如下描述。
通信指令格式名稱
類型
是否必填
描述
cmd
String
是
指令名稱，詳情可查看 通信指令。
args
JsonArray
是
指令參數(shù)，詳情可查看 通信指令。
通信指令setConfigs
說(shuō)明：設(shè)置讀卡器配置信息。
命令范例： {'cmd':'setConfigs', 'args':[{"configName":"configValue"}]}。
參數(shù)數(shù)量：n
參數(shù)序號(hào)
參數(shù)類型
參數(shù)值
描述
JSON
-
要設(shè)置的配置集合。配置說(shuō)明可查看 配置列表。
回調(diào)函數(shù)
success
表示調(diào)用成功，出參：
configs：JSON 對(duì)象類型，設(shè)置后的配置結(jié)果。
fail
表示調(diào)用失敗，詳情可查看 錯(cuò)誤碼說(shuō)明。
readCard
說(shuō)明：讀取身份證信息。
命令范例： {'cmd':'readCard', 'args':[]}。
參數(shù)數(shù)量：0
參數(shù)序號(hào)
參數(shù)類型
參數(shù)值
描述
-
-
-
-
回調(diào)函數(shù)
success
表示調(diào)用成功，出參可查看 身份證信息說(shuō)明。
fail
表示調(diào)用失敗，詳情可查看 錯(cuò)誤碼說(shuō)明。
enableAutoRead
說(shuō)明：打開(kāi)自動(dòng)讀卡模式。
命令范例： {'cmd':'enableAutoRead', 'args':[]}。
參數(shù)數(shù)量：0
參數(shù)序號(hào)
參數(shù)類型
參數(shù)值
描述
-
-
-
-
回調(diào)函數(shù)
success
表示調(diào)用成功。
fail
表示調(diào)用失敗，詳情可查看 錯(cuò)誤碼說(shuō)明。
disableAutoRead
說(shuō)明：關(guān)閉自動(dòng)讀卡模式。
命令范例： {'cmd':'disableAutoRead', 'args':[]}。
參數(shù)數(shù)量：0
參數(shù)序號(hào)
參數(shù)類型
參數(shù)值
描述
-
-
-
-
回調(diào)函數(shù)
success
表示調(diào)用成功。
fail
表示調(diào)用失敗，詳情可查看 錯(cuò)誤碼說(shuō)明。
出參成功名稱
類型
描述
success
Boolean
值為 true。
返回內(nèi)容為 { success : true,…… } 根據(jù)不同的通信指令攜帶不同的出參，詳細(xì)定義見(jiàn)各 通信指令 success 回調(diào)說(shuō)明。
失敗名稱
類型
描述
error
Number
錯(cuò)誤碼。
errorMessage
String
詳細(xì)錯(cuò)誤描述。
返回內(nèi)容只包含 {error: number, errorMessage: '詳細(xì)錯(cuò)誤描述'}返回錯(cuò)誤碼定義和錯(cuò)誤碼描述見(jiàn) 錯(cuò)誤碼說(shuō)明。
錯(cuò)誤碼說(shuō)明error
類型
說(shuō)明（errorMessage)
2001
Number
未知錯(cuò)誤
2002
Number
讀卡器不支持
2003
Number
連接讀卡器失敗
2004
Number
無(wú)訪問(wèn)權(quán)限
2005
Number
尋卡失敗
2006
Number
選卡失敗
2007
Number
讀卡錯(cuò)誤
2008
Number
證照讀取失敗
2009
Number
認(rèn)證失敗
附錄身份證信息說(shuō)明名稱
類型
描述
type
String
native：本地讀卡器返回值。
cloud_sunmi：商米云讀卡數(shù)據(jù)類型。
message
String
如果 type 為 cloud_*，如 cloud_sunmi，返回云讀卡數(shù)據(jù)。小程序應(yīng)該將此值回傳到服務(wù)商應(yīng)用服務(wù)器，應(yīng)用服務(wù)器調(diào)用商米云解碼進(jìn)行解碼，請(qǐng)查看 身份證云識(shí)別服務(wù)。
如果 type 為其它類型，值為空字符串 ""。
info
JSON
本地讀卡器：各廠商的原始輸出。
云讀卡器：為空字符串口 ""。
photo
String
本地讀卡器：照片的 base64 string。
云讀卡器：空字符串 ""。
firstFP
String
本地讀卡器：枚指紋信息。
云讀卡器：空字符串 ""。
secondFP
String
本地讀卡器：第二枚指紋信息。
云讀卡器：空字符串 ""。
配置列表名稱
類型
是否必填
描述
interval
Int
非必填
自動(dòng)讀卡間隔。
默認(rèn)值 1000，單位 ms。
取值范圍：[100, 10000]
fingerPrint
boolean
非必填
是否讀取指紋信息。
只針對(duì)支持的讀卡器生效。
默認(rèn)值 true。
server
String
云讀卡器必填
云讀卡服務(wù)器名。
appId
String
云讀卡器必填
注冊(cè)云讀卡服務(wù)的 appId，用于底層獲取身份證信息。
dispatchServer
String
Lotus云讀卡器必填
調(diào)度服務(wù)器地址。
szServer
String
Lotus讀卡器必填
模塊服務(wù)器地址。
account
Int
Lotus讀卡器必填
用戶賬號(hào)。
password
String
Lotus讀卡器必填
調(diào)度服務(wù)器登錄密碼。
postcode
Long
Lotus讀卡器必填
郵政編碼。
network
Int
Lotus讀卡器必填
網(wǎng)絡(luò)類型。
0 : 未知。
1 : 電信。
2 : 聯(lián)通。
3 : 移動(dòng)。
4 : 其它。
timeout
Long
Lotus讀卡器必填
接收超時(shí)時(shí)間，單位秒。
mainServerAddr
String
中軟高科讀卡器必填
主服務(wù)器地址。
mainServerPort
Int
中軟高科讀卡器必填
主服務(wù)器端口號(hào)。
subServerAddr
String
中軟高科讀卡器必填
子服務(wù)器地址。
subServerPort
Int
中軟高科讀卡器必填
子服務(wù)器端口號(hào)。
companyId
String
中軟高科讀卡器必填
公司標(biāo)識(shí)。