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:'', //字符串类型,联网获取到的授权字符串
}
示例代码
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及更高版本