更新记录

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

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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);
                }
            );

隐私、权限声明

1. 本插件需要申请的系统权限列表:

安卓权限 android.permission.INTERNET 允许应用联网,SDK联网授权。 ios 权限 访问相机权限

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件采集的数据、发送的服务器地址、以及数据用途说明: 本插件不会采集任何用户数据,具体请访问旷视开放平台:https://faceid.com/document/faceid-guide-docs/app_access_guidence

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问