haierFaceId

概述

haierFaceId 封装了FACE++SDK的活体检测功能,FACE++SDK 集成了 Face++ 人脸识别技术的活体验证算法。算法通过动作指令,要求用户完成特定的点头、摇头、眨眼或者张嘴的动作,达到活体检测的目的。算法可以有效的防止各种安全性攻击,包括但不限于换人、视频、面具、翻拍等攻击手段。插件同时集成了 Face++ 图像识别技术的身份证采集算法。算法采集并分析身份证的文字清晰度、光斑、阴影等质量信息,给出调整的提示,确保最终采集到质量高,利于留存验证的身份证图像。平台地址FaceID平台

插件的人脸识别过程

1.授权后,直接进行人脸识别

2.可获取到一张人脸最好的照片

3.需要开发者自己利用得到的照片和身份证上的图片去对比(开发者可通过旷视的身份证API去实现(https://faceid.com/pages/documents/10881005))

兼容性

FACE++ iOS 系列SDK 支持 iOS7及以上操作系统,为了提高效果,推荐使用iPhone4S 以上机器,不包含iPhone4S。

注意:客户端SDK需要授权才能使用,我们需要您绑定您客户端APP的Bundle ID,以便FaceID识别您的客户端应用。 目前,客户端 SDK 通过联网进行授权,需要将您的APP的 Bundle ID 与 SDK 绑定以进行授权识别 。

在iOS端需勾选相机、相册、麦克风的权限,否则会导致崩溃。

auth

SDK网络授权

auth(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
   status: true      //数字类型;授权成功
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    code: 1     //数字类型;
                //1(授权失败)
}

示例代码

var haierFaceId = api.require('haierFaceId');
haierFaceId.auth(function(ret, err){
    if(ret){
        alert("SDK网络授权成功");
    }else{
        alert('SDK网络授权失败');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

opencustomDetect

打开人脸活体检测

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

params

actionArray:

  • 类型:活体数组
  • 描述:活体动作
  • 默认:[1]
  • 取值范围:[1-4]
  • 1 (眨眼)
  • 2 (张嘴)
  • 3 (左右转头)
  • 4 (上下点头)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    eventType: 'show',             //字符串类型;
                                   //取值范围:
                                   //show(插件打开成功)
                                   //succeed(检测成功)
  imagePath: '',                   //字符串类型;返回的质量最佳的人脸图片 (仅当eventType为succeed时返回)  
  imageEnvPath: '',                //字符串类型;用于假脸判定 (仅当eventType为succeed时返回) 
  delta:''                         //字符串类型;在配合MegLive SDK使用时,用于校验上传数据的校验字符串                              
}

示例代码

var haierFaceId = api.require('haierFaceId');
haierFaceId.openCustomDetect({
actionArray:[1,2]
},function(ret, err) {
    if (ret) {
       alert(JSON.stringify(ret));
    } else {
       alert(JSON.stringify(err));
    }            
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getLicenseContext

获取授权所需参数,与authWidhtContext接口配合使用

getLicenseContext(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
   status: true,      //布尔类型;是否获取成功
    context:'',   //字符串类型,拿到此内容可通过旷视接口获取licence
}

示例代码

var haierFaceId = api.require('haierFaceId');
haierFaceId.getLicenseContext(function(ret, err){
    if(ret.status){
        alert("获取成功");
    }
});

可用性

iOS系统,Android系统

可提供的1.0.3及更高版本

getLicence

联网获取授权,与getLicenseContext接口配合使用

getLicence(callback(ret))

params

context:

  • 类型:字符串类型
  • 描述:通过getLicenseContext获取到的context

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
   status: true,      //布尔类型类型;
   licence:'',      //字符串类型,联网获取到的授权字符串,仅Android端返回值
   licenceInfo:'',   //JSON类型,licence信息,仅iOS端返回值
}

示例代码

var haierFaceId = api.require('haierFaceId');
haierFaceId.getLicence({
    context:''
},function(ret, err){
    
});

可用性

iOS系统,Android系统

可提供的1.0.3及更高版本

authWithLicence

通过旷视接口获取的licence授权,与getLicence接口配合使用

authWithLicence(callback(ret))

params

licence:

  • 类型:字符串类型
  • 描述:通过旷视服务器接口获取到的licence授权

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{
   status: true,      //布尔类型类型;授权是否成功
   setInfo:'',   //JSON类型,设置licence信息,仅iOS端返回
}

示例代码

var haierFaceId = api.require('haierFaceId');
haierFaceId.authWithLicence({
    license:''
},function(ret, err){
    if(ret.status){
        alert("授权成功");
    }
});

可用性

iOS系统,Android系统

可提供的1.0.3及更高版本

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