中软高科身份证云解码读卡器支付宝IoT小程序适配(一)

中软高科云读卡器已支持支付宝IoT小程序的身份证读卡器适配，详见链接：支付宝IoT小程序身份证读卡器适配

下面简单介绍一下相关API的具体说明。

1、my.ix.cardReaderCommand

简介：读卡器通信接口，用于设置读卡器参数，读写卡等操作。

使用限制：

类别	型号	连接方式	VID,PID(十进制）	说明
云读卡器	中软高科云读卡器	USB	49686, 258	-

接口调用

示例代码

.js 示例代码

设置云读卡

my.ix.cardReaderCommand({
  cmds: {'cmd':'setConfigs', 'args': [{'server':'sunmi', 'appId':'f88548a4e6633266b11bc3019810c582'}]},
  success: (r) => {
    this.setData({
      message: "设置成功--> " +JSON.stringify(r)
    })
  },
  fail: (r) => {
    this.setData({
      message: "设置失败--> " +JSON.stringify(r)
    })
  },
});

读卡

my.ix.cardReaderCommand({
  cmds: {'cmd':'readCard', 'args': []},
  success: (r) => {
    this.onCardInfo(r)
  },
  fail: (r) => {
    this.setData({
      message: "读卡失败--> " +JSON.stringify(r)
    })
  },
});

入参

名称

类型

是否必填

描述

target

Number

否

要与之通信的读卡器 id，通过 my.ix.getDevices 获得。如果不填，默认系统接入的第 1 个读卡器设备。

cmds

JSON

是

JSON 格式： {'cmd': '...', 'args': ['...']}

通信指令，如下描述。

通信指令格式

名称	类型	是否必填	描述
cmd	String	是	指令名称，详情可查看通信指令。
args	JsonArray	是	指令参数，详情可查看通信指令。

通信指令

setConfigs

说明：设置读卡器配置信息。

命令范例： {'cmd':'setConfigs', 'args':[{"configName":"configValue"}]}。

参数数量：n
参数序号	参数类型	参数值	描述
0	JSON	-	要设置的配置集合。配置说明可查看配置列表。
回调函数
success	表示调用成功，出参： configs：JSON 对象类型，设置后的配置结果。
fail	表示调用失败，详情可查看错误码说明。

readCard

说明：读取身份证信息。

命令范例： {'cmd':'readCard', 'args':[]}。

参数数量：0
参数序号	参数类型	参数值	描述
-	-	-	-
回调函数
success	表示调用成功，出参可查看身份证信息说明。
fail	表示调用失败，详情可查看错误码说明。

enableAutoRead

说明：打开自动读卡模式。

命令范例： {'cmd':'enableAutoRead', 'args':[]}。

参数数量：0
参数序号	参数类型	参数值	描述
-	-	-	-
回调函数
success	表示调用成功。
fail	表示调用失败，详情可查看错误码说明。

disableAutoRead

说明：关闭自动读卡模式。

命令范例： {'cmd':'disableAutoRead', 'args':[]}。

参数数量：0
参数序号	参数类型	参数值	描述
-	-	-	-
回调函数
success	表示调用成功。
fail	表示调用失败，详情可查看错误码说明。

出参

成功

名称	类型	描述
success	Boolean	值为 true。
返回內容为 { success : true,…… } 根据不同的通信指令携带不同的出参，详细定义见各通信指令 success 回调说明。

失败

名称	类型	描述
error	Number	错误码。
errorMessage	String	详细错误描述。
返回内容只包含 {error: number, errorMessage: '详细错误描述'}返回错误码定义和错误码描述见错误码说明。

错误码说明

error	类型	说明（errorMessage)
2001	Number	未知错误
2002	Number	读卡器不支持
2003	Number	连接读卡器失败
2004	Number	无访问权限
2005	Number	寻卡失败
2006	Number	选卡失败
2007	Number	读卡错误
2008	Number	证照读取失败
2009	Number	认证失败

附录

身份证信息说明

名称	类型	描述
type	String	native：本地读卡器返回值。 cloud_sunmi：商米云读卡数据类型。
message	String	如果 type 为 cloud_*，如 cloud_sunmi，返回云读卡数据。小程序应该将此值回传到服务商应用服务器，应用服务器调用商米云解码进行解码，请查看身份证云识别服务。如果 type 为其它类型，值为空字符串 ""。
info	JSON	本地读卡器：各厂商的原始输出。云读卡器：为空字符串口 ""。
photo	String	本地读卡器：照片的 base64 string。云读卡器：空字符串 ""。
firstFP	String	本地读卡器：第一枚指纹信息。云读卡器：空字符串 ""。
secondFP	String	本地读卡器：第二枚指纹信息。云读卡器：空字符串 ""。

配置列表

名称	类型	是否必填	描述
interval	Int	非必填	自动读卡间隔。默认值 1000，单位 ms。取值范围：[100, 10000]
fingerPrint	boolean	非必填	是否读取指纹信息。只针对支持的读卡器生效。默认值 true。
server	String	云读卡器必填	云读卡服务器名。
appId	String	云读卡器必填	注册云读卡服务的 appId，用于底层获取身份证信息。
mainServerAddr	String	中软高科读卡器必填	主服务器地址。
mainServerPort	Int	中软高科读卡器必填	主服务器端口号。
subServerAddr	String	中软高科读卡器必填	子服务器地址。
subServerPort	Int	中软高科读卡器必填	子服务器端口号。
companyId	String	中软高科读卡器必填	公司标识。

电子读卡器栏位说明

中华人民共和国身份证信息		说明
certType	证件类别	默认为" "
dn	dn码	-
uuid	UUID	-
issue	签发机关	-
name	名字	-
sex	性别	-
nation	民族	-
birthDay	生日	返回 YYMMDD 格式，如："19960116"。
addr	地址	-
idCard	身份证号	-
startDate	有效期开始日期	返回 YYMMDD 格式，如："19960116"。
endDate	有效期结束日期	返回 YYMMDD 格式，如："19960116"。
newAddr	最新地址	-
fpData	指纹数据	原始指纹数据的 base64 编码字符串。
wltData	照片数据	原始未解码照片数据的 base64 编码字符串。
photo	照片数据	解码后的png格式照片符合Data URI scheme格式以"data:image/png;base64,"开头

中华人民共和国港澳台居住证信息		说明
certType	证件类别	港澳台居留证："J"
dn	dn码	-
uuid	UUID	-
issue	签发机关	-
issuesNum	签发次数
passCheckID	通行证号码
name	名字
sex	性别
birthDay	生日
addr	地址
idCard	身份证号
startDate	有效期开始日期
endDate	有效期结束日期
fpData	指纹数据
wltData	照片数据
photo	照片数据	解码后的png格式照片符合Data URI scheme格式以"data:image/png;base64,"开头

中华人民共和国外国人永久居留证信息（2017版）		说明
certType	证件类别	"I"
dn	dn码	-
uuid	UUID	-
issue	签发机关	-
englishName	英文名字	-
chineseName	中文名字	-
sex	性别	-
nationCode	国籍	-
birthDay	生日	-
idCard	永久居留证号	-
startDate	有效期开始日期	-
endDate	有效期结束日期	-
certVer	证件版本号，4字节	-
fpData	指纹数据（空）	-
wltData	照片数据	-
photo	照片数据	解码后的png格式照片符合Data URI scheme格式以"data:image/png;base64,"开头

中华人民共和国外国人永久居留证信息（新版）		说明
certType	证件类别	"Y"
dn	dn码	-
uuid	UUID	-
renewalNumber	签发次数	-
englishName	英文名字	-
englishNameAdd	英文附加名字	-
chineseName	中文名字	-
sex	性别	-
nationCode	国籍	-
birthDay	生日	-
idCard	永久居留证号	-
historicalNumber	既往版本外国人永久居留证件号码	-
startDate	有效期开始日期	-
endDate	有效期结束日期	-
fpData	指纹数据（空）	-
wltData	照片数据	-
photo	照片数据	解码后的png格式照片符合Data URI scheme格式以"data:image/png;base64,"开头

标签：String,必填,适配,中软,Number,说明,读卡,读卡器
From： https://blog.csdn.net/weixin_39406065/article/details/144368797