hanvonCloudIdCardReader

来自于：汉王立即使用

recognitionIdCard

概述

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

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

名称：HanvonCloudIdCard

参数：androidkey，ioskey

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

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

recognitionIdCard

识别身份证

recognitionIdCard(params,callback(ret, err))

params

androidkey：

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

ioskey：

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

picpath：

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

callback(ret, err)

ret：

  • 类型：JSON对象

  • 内部字段：

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

    err：

  • 类型：JSON对象

  • 内部字段：

    1. {
    2. msg: //错误描述 
    3. }

示例代码

  1. var recIdCard = api.require('hanvonCloudIdCardReader');
  3. api.getPicture({
  4.     sourceType : 'library',
  5.     encodingType : 'jpg',
  6.     mediaValue : 'pic',
  7.     destinationType : 'url',
  8.     allowEdit : true,
  9.     quality : 100,
  10.     saveToPhotoAlbum : false
  11. }, function(ret, err) {
  12.     if (ret) {
  13.         url = ret.data;
  14.         console.log(url);
  15.         recIdCard.recognitionIdCard({
  16.             androidkey : "163114c8-31b5-4424-bb85-617f81cf54d9",                            
  17.             picpath : url
  18.         }, function(ret, err) {
  19.             if (ret.status) {
  20.                 api.alert({
  21.                     title : "识别结果",
  22.                     msg : ret.result
  23.                 });
  24.             } else {
  25.                 api.alert({
  26.                     title : "识别结果",
  27.                     msg : err.msg
  28.                 });
  29.             }
  30.         });
  31.     } else {
  32.         alert(JSON.stringify(err));
  33.     }
  34. });

可用性

Android和iOS系统

可提供的1.0.0及更高版本