hanvonCloudIdCardReader

来自于:汉王立即使用

概述

hanvonCloudIdCardReader模块封装了汉王云身份证识别的sdk,可通过选择相册中的身份证读取身份证信息。

在集成此模块之前可先配置config文件,也可不配置config文件直接从前端js将androidkey传入模块原生代码。在config里添加如下字段:

名称:HanvonCloudIdCard

参数:androidkey,ioskey

描述:androidkey即是从汉王云官网开发者中心 应用管理 Key管理中生成的android key, ioskey即是从汉王云官网开发者中心 应用管理 Key管理中生成的ios key

  • 配置示例:
<feature name="hanvonCloudIdCardReader"> 
<param name="androidkey" value="163114c8-31b5-4424-bb85-617f81cf54d9" /> 
<param name="ioskey" value="01170ffa-f0e4-4ac8-936c-b3e3de68f090"/>
</feature>

recognitionIdCard

识别身份证

recognitionIdCard(params,callback(ret, err))

params

androidkey:

  • 类型:字符串
  • 描述:在汉王云官网申请的android key

ioskey:

  • 类型:字符串
  • 描述:在汉王云官网申请的ios key

picpath:

  • 类型:字符串
  • 描述:身份证的存放路径

callback(ret, err)

ret:

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

    {
       status: //识别身份证状态值 
       result:  //识别身份证结果
          {
                  code:0,                         //识别返回码
          result:,                        //消息内容
          name: "韦小宝",                  //姓名
                  gender: "男",                    //性别
          people: "土",                    //民族
          byear: "1651",                   //出生年
          bmonth: "12",                    //出生月
          bday: "1",                       //出生日
          address: "北京市东召山",         //住址
          idnumber: "112814165112202111",  //公民身份证号
          authority: "",                   //签发机关
          validdate: "",                   //有效期限
          left: 211,                       //身份证头像左边距
          top: 25,                         //身份证头像上边距
          right: 312,                      //身份证头像右边距
          bottom: 169,                     //身份证头像下边距
          croppedImage: "",                //身份证切割图的base64串(仅切图版有值)
          headImage: ""                    //身份证头像图片的base64串(仅切图版有值)
    
           }
    }
    

    err:

  • 类型:JSON对象

  • 内部字段:
    {
    msg: //错误描述 
    }
    

示例代码

var recIdCard = api.require('hanvonCloudIdCardReader');

api.getPicture({
    sourceType : 'library',
    encodingType : 'jpg',
    mediaValue : 'pic',
    destinationType : 'url',
    allowEdit : true,
    quality : 100,
    saveToPhotoAlbum : false
}, function(ret, err) {
    if (ret) {
        url = ret.data;
        console.log(url);
        recIdCard.recognitionIdCard({
            androidkey : "163114c8-31b5-4424-bb85-617f81cf54d9",                            
            picpath : url
        }, function(ret, err) {
            if (ret.status) {
                api.alert({
                    title : "识别结果",
                    msg : ret.result
                });
            } else {
                api.alert({
                    title : "识别结果",
                    msg : err.msg
                });
            }
        });
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android和iOS系统

可提供的1.0.0及更高版本