jdFace

/* Title: jdFace Description: jdFace */

init

detectActive

detectSilent

cancleActive

cancleSilent

概述

jdFace 封装了金蝶人脸识别sdk，可指定动作，指定动作顺序进行活体检测。

使用此插件之前建议先配置 config.xml 文件，配置完毕，需通过云端编译生效，配置方法如下：

  • 名称：jdFace
  • 参数：apiKey、apiSecret
  • 配置示例：
 <feature name="jdFace">
   <param name="apiKey" value="" />
   <param name="apiSecret" value="" />
 </feature>
  • 字段描述：

apiKey：（必须配置）金蝶平台API_KEY

apiSecret：（必须配置）金蝶平台API_SECRET

android编译说明

  • 使用升级环境编译
  • 最低版本支持到4.4以上

init

初始化，加载sdk配置文件

init()

示例代码

var jdFace= api.require('jdFace');
jdFace.init();

可用性

Android系统

可提供的1.0.0及更高版本

detectActive

进行交互活体检测

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

params

actions:

  • 类型：JSON数组
  • 描述：活体检测动作以及排序，数组内item必须为取值范围内容
  • 取值范围：0/眨眼、1/张嘴、2/点头、3/摇头
  • 例：‘[0,1,2,3]’

complexity:

  • 类型：数字类型
  • 描述：活体检测困难程度（可选）
  • 取值范围：1/简单、2/正常、3/困难、4/非常困难
  • 默认：2

voice:

  • 类型：布尔类型
  • 描述：声音提示；true/开启声音提示，false/关闭声音提示（可选）
  • 默认：true

immersion:

  • 类型：布尔类型
  • 描述：设置页面沉浸式；true/沉浸式，false/非沉浸式（可选）（仅Android支持）
  • 默认：false

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status: true,           //布尔型；是否判断成功
   id:'',                   //字符类型；回传加密后的二进制数据在公有云的id
   requestId:'',            //字符类型；网络请求的id
   data:'',               //字符类型；回传加密后的二进制数据（base64）
   images:[]               //JSON数组；检测成功后活体验证的图片
}

err：

  • 类型：JSON 对象
  • 内部字段：
{
   errorCode:0,              //数字类型；错误码
   msg:''                   //错误信息
  }

错误码参考 0：未知错误 1：取消 2：缺少权限 3：相机打开错误 4：检测超时 5：授权文件不存在 6：未通过授权验证 7：授权文件过期 8：绑定包名错误 9：活体检测失败 10：动作幅度太大，请保持人脸在屏幕中央 11：面部遮挡 12：网络超时 13：API_KEY错误 14：服务器访问错误 15：参数不合法

示例代码

var jdFace= api.require('jdFace');
jdFace.detectActive(function(ret, err) {
});

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

detectSilent

进行静默活体检测

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

params

duration:

  • 类型：数字类型
  • 描述：最短检测时常；建议至少为1s, 0表示无最小时间限制，不得小于0（可选）
  • 单位：秒（s）
  • 默认：3

frames:

  • 类型：数字类型
  • 描述：最少检测贞数；0表示无最小帧数限制，不得小于0（可选）
  • 默认：4

timeOut:

  • 类型：数字类型
  • 描述：设置超时时间；等于0时为不超时，大于0时为设置的值，不得小于0（可选）
  • 单位：秒（s）
  • 默认：10

farRate:

  • 类型：小数类型
  • 描述：人脸高度/宽度占图像短边的比例；参数设置越靠近0，代表人脸距离屏幕越远，如果设置为0，则无过远提示。（可选）
  • 取值范围：[0.0~1.0]
  • 默认：0.4

closeRate:

  • 类型：小数类型
  • 描述：人脸高度/宽度占图像短边的比例；参数设置越靠近1，代表人脸距离屏幕越近，如果设置为0，则无过近提示。（可选）
  • 取值范围：[0.0~1.0]
  • 默认：0.8

immersion:

  • 类型：布尔类型
  • 描述：设置页面沉浸式；true/沉浸式，false/非沉浸式（可选）（仅Android支持）
  • 默认：false

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status: true,           //布尔型；是否判断成功
   images:[],               //JSON数组；检测成功后活体验证的图片
   id:'',                   //静默活体检测加密文件id
   requestId:'',          //网络请求id
   faceRect:{              //检测图片中人脸框位置
   
        left:                    //人脸左边框坐标
        top:                   //人脸上边框坐标
        right:					//人脸右边框坐标
        bottom:             //人脸下边框坐标
   }
  }

err：

  • 类型：JSON 对象
  • 内部字段：
{
errorCode:0              //数字类型；错误码
   msg:''                       //错误信息
  }

错误码参考 0：未知错误 1：取消 2：缺少权限 3：相机打开错误 4：检测超时 5：授权文件不存在 6：未通过授权验证 7：授权文件过期 8：绑定包名错误 9：活体检测失败 10：动作幅度太大，请保持人脸在屏幕中央 11：面部遮挡 12：网络超时 13：API_KEY错误 14：服务器访问错误 15：参数不合法

示例代码

var jdFace= api.require('jdFace');
jdFace.detectSilent(function(ret, err) {
});

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

cancleActive

取消交互活体检测

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

params

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status: true,           //布尔型；是否取消成功
  }

err：

  • 类型：JSON 对象
  • 内部字段：
{
   msg:''                       //错误信息
  }

示例代码

var jdFace= api.require('jdFace');
jdFace.cancleActive(function(ret, err) {
});

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

cancleSilent

取消静默活体检测

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

params

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status: true,           //布尔型；是否取消成功
  }

err：

  • 类型：JSON 对象
  • 内部字段：
{
   msg:''                       //错误信息
  }

示例代码

var jdFace= api.require('jdFace');
jdFace.cancleSilent(function(ret, err) {
});

可用性

Android系统，IOS系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/12/2