SAMIDCard

来自于：开发者立即使用

• Method

getSAMStatus getSAMID findIDCard findIDCardKeep stopFindIDCardKeep 附录

概述

身份证模块

模块接口

getSAMStatus

获取扫描模块状态

getSAMStatus({params}, callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

• 类型：JSON 对象
• 内部字段：

{
errorCode:,                //字符串类型；错误码，详见附录
msg:'',                        //字符串类型；错误信息
}

示例代码

var SAMIDCard = api.require('SAMIDCard');
SAMIDCard.getSAMStatus({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

getSAMID

获取模块编码SAMID即安全模块编号

getSAMID({params}, callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否成功
    samid:'',                    //字符串类型；安全模块编号
}

err：

• 类型：JSON 对象
• 内部字段：

{
errorCode:,                //字符串类型；错误码，详见附录
msg:'',                        //字符串类型；错误信息
}

示例代码

var SAMIDCard = api.require('SAMIDCard');
SAMIDCard.getSAMID({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

findIDCard

读取一次身份证信息

findIDCard({params}, callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否成功
    info:{                         //JSON对象类型；身份证信息
       name:'',                //字符串类型；姓名
       sex:'',                   //字符串类型；性别
       nation:'',              //字符串类型；民族
       birth:'',                //字符串类型；出生日期
       address:'',           //字符串类型；住址
       idNumber:'',          //字符串类型；身份证号码
       sign:''.                   //字符串类型；颁发机关
       startValid:'',           //字符串类型；有效期起始日期
       endValid:'',             //字符串类型；有效期截止日期
       photo:'',                 //字符串类型；照片路径
    }
}

err：

• 类型：JSON 对象
• 内部字段：

{
errorCode:,                //字符串类型；错误码，详见附录
msg:'',                        //字符串类型；错误信息
}

示例代码

var SAMIDCard = api.require('SAMIDCard');
SAMIDCard.findIDCard({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

findIDCardKeep

一直读取身份信息，直到读取到身份证

findIDCardKeep({params}, callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否成功
    info:{                         //JSON对象类型；身份证信息
       name:'',                //字符串类型；姓名
       sex:'',                   //字符串类型；性别
       nation:'',              //字符串类型；民族
       birth:'',                //字符串类型；出生日期
       address:'',           //字符串类型；住址
       idNumber:'',          //字符串类型；身份证号码
       sign:''.                   //字符串类型；颁发机关
       startValid:'',           //字符串类型；有效期起始日期
       endValid:'',             //字符串类型；有效期截止日期
       photo:'',                 //字符串类型；照片路径
    }
}

err：

• 类型：JSON 对象
• 内部字段：

{
errorCode:,                //字符串类型；错误码，详见附录
msg:'',                        //字符串类型；错误信息
}

示例代码

var SAMIDCard = api.require('SAMIDCard');
SAMIDCard.findIDCardKeep({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

stopFindIDCardKeep

停止一直读取身份信息

stopFindIDCardKeep({params}, callback(ret))

callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:true,                //布尔类型；是否成功
}

err：

• 类型：JSON 对象
• 内部字段：

{
errorCode:,                //字符串类型；错误码，详见附录
msg:'',                        //字符串类型；错误信息
}

示例代码

var SAMIDCard = api.require('SAMIDCard');
SAMIDCard.stopFindIDCardKeep({
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

附录

errorCode

0x89： 初始化失败，没有usb设备或权限 0x91： 居民身份证中此项无内容 0x9F： 寻找居民身份证成功 0x02： 接收超时，在规定的时间内未接收到规定长度的数据。 0x03： 数据传输错误 0x10： 接收业务终端数据的校验和错 0x11： 接收业务终端数据的长度错。 0x21： 接收业务终端的命令错误，包括命令中的各种数值或逻辑搭配错误 0x23： 越权操作 0x24： 无法识别的错误 0x80： 寻找证/卡失败 0x81： 选取证/卡失败 0x31： 证/卡证认SAM_A失败 0x32： SAM_A认证证/卡失败 0x33： 信息验证错误 0x40： 无法识别的居民身份证类型 0x41： 读取居民身份证操作失败 0x47： 读取随机数失败 0x60： SAM_A自检失败，不能接收命令 0x66： SAM_A没经过授权,无法使用