mgCard

openVideoDetection detectImage

概述

封装了Face++的身份证质量检测 SDK

注意:本模块 iOS 平台上最低适配系统版本为 iOS 8.0

licenseForNetwork

调用联网授权代码进行授权

licenseForNetwork({params}, callback(ret, err))

key:

  • 类型:字符串类型
  • 描述:apiKey,访问 官网,登录后在控制台生成对应的key

secret:

  • 类型:字符串类型
  • 描述:apiSecret,访问 Face++官网,登录后在控制台生成对应的secret

url:

  • 类型:字符串类型
  • 描述:(可选项)url
  • 默认:’‘

duration:

  • 类型:字符串类型
  • 描述:(可选项)appKey有效期
  • 默认:1

callback(ret, err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
  1. msg:'' //错误原因
  2. }

示例代码

  1. var mgCard= api.require('mgCard');
  2. mgCard.licenseForNetwork({
  3. key:'',
  4. secret:''
  5. },function(ret, err) {
  6. if (ret.status) {
  7. alert('成功');
  8. }
  9. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

openVideoDetection

openVideoDetection({params}, callback(ret, err))

isCard:

  • 类型:数字类型
  • 描述:(可选项)是否为证件
  • 取值范围:0 - 1.0

inBound:

  • 类型:数字类型
  • 描述:(可选项)是否在引导框内
  • 取值范围:0 - 1.0
  • 默认:0.8

clear:

  • 类型:数字类型
  • 描述:(可选项)是否清晰
  • 取值范围:0 - 1.0
  • 默认:0.8

shadowAreaTh:

  • 类型:数字类型
  • 描述:(可选项)被判定为阴影的最小面积
  • 取值范围:0 - 256*160
  • 默认:300

faculaAreaTh:

  • 类型:数字类型
  • 描述:(可选项)被判定为光斑的最小面积
  • 默认:300

cardAreaTh:

  • 类型:数字类型
  • 描述:(可选项)被判定为身份证的最小面积
  • 默认:20

flareType:

  • 类型:布尔类型
  • 描述:(可选项)光斑检测是否过滤
  • 默认:true

callback(ret, err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'' //错误原因
  3. }

示例代码

  1. var mgCard= api.require('mgCard');
  2. mgCard.openVideoDetection({
  3. isCard:0.9,
  4. flareType:true
  5. console.log(JSON.stringify(ret))
  6. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

closeVideoDetection

关闭视频检测页面

可用性

iOS、Android系统

可提供的1.0.0及更高版本

detectImage

检测图片

detectImage({params}, callback(ret, err))

params

imagePath:

  • 类型:字符串类型
  • 描述:检测图片路径,支持fs、widget、base64

isCard:

  • 类型:数字类型
  • 描述:(可选项)是否为证件
  • 取值范围:0 - 1.0
  • 默认:0.9

inBound:

  • 类型:数字类型
  • 描述:(可选项)是否在引导框内
  • 取值范围:0 - 1.0
  • 默认:0.8

clear:

  • 类型:数字类型
  • 描述:(可选项)是否清晰
  • 取值范围:0 - 1.0
  • 默认:0.8

shadowAreaTh:

  • 描述:(可选项)被判定为阴影的最小面积
  • 取值范围:0 - 256*160
  • 默认:300

faculaAreaTh:

  • 类型:数字类型
  • 描述:(可选项)被判定为光斑的最小面积
  • 默认:300

cardAreaTh:

  • 类型:数字类型
  • 描述:(可选项)被判定为身份证的最小面积
  • 默认:20

flareType:

  • 类型:布尔类型
  • 描述:(可选项)光斑检测是否过滤
  • 默认:true

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false;是否成功
  3. cardInfo: { //json对象类型;身份证信息
  4. isIdcard:0, //数字类型;是否为证件
  5. inBound:0, //数字类型;是否在引导框内
  6. clear:0, //数字类型;是否清晰
  7. image:'', //字符串类型;检测的图片,整图的base64字符串
  8. cardImage:'', //字符串类型;只有身份证的区域图片的base64字符串
  9. clear:0, //数字类型;是否清晰
  10. detectRect:{ //json对象类型;图片的裁剪区域
  11. x:0, //数字类型;x坐标
  12. y:0, //数字类型;y坐标
  13. w:100, //数字类型;宽
  14. h:100 //数字类型;高
  15. },
  16. cardPointArray:[{//json数组对象类型;身份证边框点的数组
  17. y:0, //数字类型;y坐标
  18. }],
  19. shadowsArray:[{ //json数组对象类型;阴影框的数组
  20. x:0, //数字类型;x坐标
  21. y:0, //数字类型;y坐标
  22. }],
  23. faculaeArray:[{ //json数组对象类型;光斑框的数组
  24. x:0, //数字类型;x坐标
  25. y:0, //数字类型;y坐标
  26. }],
  27. }
  28. }
  1. var mgCard= api.require('mgCard');
  2. mgCard.detectImage({
  3. imagePath:'',
  4. isCard:0.9
  5. },function(ret) {
  6. alert(JSON.stringify(ret));

可用性

可提供的1.0.0及更高本