SAMIDCard

来自于:开发者立即使用

概述

身份证模块

模块接口

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没经过授权,无法使用