概述

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:'',      //字符串类型，联网获取到的授权字符串
}

示例代码

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

});

可用性

iOS系统，Android系统

可提供的1.0.3及更高版本

authWithLicence

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

getLicenseContext(callback(ret))

params

licence:

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

callback(ret, err)

ret：

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

{
   status: true,      //布尔类型类型；授权是否成功
}

示例代码

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

可用性

iOS系统，Android系统

可提供的1.0.3及更高版本