更新记录
1.0.4(2023-05-10)
新增官方API
1.0.2(2023-04-09)
1、旷视人脸活体检测
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 12.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 | 适用版本区间:11 - 16 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
接入前准备
本SDK为旷视提供的基础版活体检验SDK,建议按照如下方式接入产品 官方地址[https://faceid.com/document/faceid-guide-docs/app_access_guidence]
使用
引用插件
const FaceAPI = uni.requireNativePlugin('ainuo-meglive');
API
初始化
FaceAPI.initSdk();
获取sign (建议放服务端,之所以提供这个方法是为了方便测试)
FaceApi.getSign(String API_KEY, String SECRET)
FaceAPI.startDetect
FaceAPI.startDetect({biz_token},callback)
信息参考[https://faceid.com/document/faceid-guide-docs/app_sdk_android_preprocessing]
FaceAPI.startDetect(
{
biz_token: biz_token
},
result => {
console.log(result);
}
);
FaceAPI.startDetectForLivenessFile
FaceAPI.startDetectForLivenessFile({biz_token},callback)
ios平台无此方法直接使用startDetect代替,返回参数与安卓startDetectForLivenessFile保持一致
信息参考[https://faceid.com/document/faceid-guide-docs/app_sdk_android_preprocessing]
FaceAPI.startDetectForLivenessFile(
{
biz_token: biz_token
},
result => {
console.log(result);
}
);
result返回
字段 | 说明 |
---|---|
token | biz_token |
errorCode | 预处理结果码,具体错误码参考文档ErrorCode说明 |
errorMessage | 错误说明 |
data | 客户端验证后数据。注:需用该data调用服务端接口进行数据验证 |
fileInfo | 若getBizeToken接口传入参数get_liveness_video为1,则返回活体加密文件路径,verify成功后拿到解密key后调用getLivenessFiles接口获取解密后的文件 |
FaceAPI.getLivenessFiles
FaceAPI.getLivenessFiles(String filePath, String decryptionKey,callback)
信息参考[https://faceid.com/document/faceid-guide-docs/app_sdk_android_preprocessing]
FaceApi.startDetectVerify
开始人脸识别,并在内部调用verify接口,这个是补充接口作用是人脸识别,并在插件内部 实现了调用verify接口,会返回verify返回的信息
信息参考[https://faceid.com/document/faceid-guide-docs/app_api_get_result]
FaceAPI.startDetectVerify(
{
sign: this.sign,
biz_token: this.biz_token,//必传
sign_version: 'hmac_sha1'//必传
},
result => {
console.log(result);
}
);