更新记录

1.16.0(2024-04-10)

  1. 更新Android/IOS SDK , 防范新型AI换脸攻击 (建议赶紧更新)

1.15.0(2024-04-01)

  1. 【Android】提升活体检测精度,及用户体验
  2. 【IOS】解决小概率闪退问题

1.14.0(2024-03-16)

  1. [ANDROID] 解决 android14 闪退问题
  2. [IOS] 解决ios 概率性闪退问题,优化IOS炫彩活体用户体验
查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 适用版本区间:9 - 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原生插件配置”->”云端插件“列表中删除该插件重新选择


插件API接口说明

android 调用初始化

/**
 * SDK初始化。为了提升性能,建议在在application提前调用,否则获取token时间会比较长
 */
LivingDetectionModule.Init();

认证初始化

/**
 * 认证初始化
 * @param options(JSONObject), 包括如下字段:
 *     livingType:认证类型  1:远近,2:眨眼,3:摇头,4: 点头,5:张嘴,6: 炫彩
 *                  支持多动作,如传入12表示先做远近活体,后做眨眼活体,一次最多支持4组动作
 *     textColor:界面样式-字体颜色
 *     takeMultiImg: boolean , true : 获取结果时候返回多张照片,默认为false
 *     isRecordVideo: boolean , 是否录制视频,默认为false,如果设置为true, 那么将会在认证结束的时候将会返回视频存储的本地绝对路径
 *     progressColor:界面样式-进度条颜色
 *     progressBgColor:界面样式-进度条背景颜色
 *     progressStaGradient:界面样式-进度条渐变开始颜色
 *     progressEndGradient:界面样式-进度条渐变结束颜色
 *     backGroundColor:界面样式-页面背景颜色
 *     circleBackWidth:界面样式-进度条宽度
 *     language: 界面显示的语言(不分大小写),“CN”:中文,“JP”: 日文,"KR": 韩文
 *     visitedStepBorderDotColor:多动作导航的边框颜色, 如 #FFC0CB
 *     visitedStepFillDotColor: 完成步骤点的填充颜色, 如 #FFC0CB
 *     nextStepBorderDotColor: 下一步骤点的填充颜色, 如 #FFC0CB
 *     nextStepFillDotColor: 下一步骤点的填充颜色, 如 #FFC0CB
 *     visitedStepSeparatorColor:  当前步骤条的颜色, 如 #FFC0CB
 *     nextStepSeparatorColor: 下一步步骤条的颜色, 如 #FFC0CB
 *     exitIcon: 退出按钮图片(BASE64字符串)
 * @return livingDetectResult 对象包括如下几个字段
 * {
 *      "code": ”ELD_SUCCESS“, -- ELD_SUCCESS:成功,ELD_FAILED:失败,ELD_PARAME_ERROR:参数异常,ELD_EXCEPTION:发生异常,ELD_UNSUPPORT:不支持此活体类型
 *      "msg":”成功“, -- 执行结果描述
 *      "data": "......" -- 执行结果数据
 * }
 */
 livingDetectResult LivingDetectionModule.verifyInit(options);

发起活体认证

/*
 * 执行活体认证
 * @param options(JSONObject), 包括如下字段:
 *     token:认证初始化服务器端返回的数据
 * @param callback 执行结果回调,传入参数为对象 livingDetectResult 对象包括如下几个字段
 * {
 *      "code": ”ELD_SUCCESS“, -- ELD_SUCCESS:成功,ELD_FAILED:失败,ELD_PARAME_ERROR:参数异常,ELD_EXCEPTION:发生异常,ELD_TIMEOUT:执行超时,ELD_PERMISSION:无法获取相机授权,ELD_CANCEL: 用户主动退出
 *      "msg":”成功“, -- 执行结果描述
 *      "data": "......" -- 执行结果数据
 *      "token": "" -- 本次认证token
 *      "videoPath": "/storage/xxxxx" -- 录制视频存储的绝对路径
 * }
 */
LivingDetectionModule.startLivingDetect(options, callback);

页面样式修改

Android

ANDRIOID STYLE

IOS

IOS STYLE

隐私、权限声明

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

"android.permission.CAMERA"

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

采集人脸数据 用于活体检测 (插件本身不连接互联网,不会私自上传任何数据) 隐私协议详情 https://esandinfo.yuque.com/docs/share/66f4c015-32ab-4eb6-8c78-6c419cac2043?# 《用户隐私协议》

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

不包含任何广告

许可协议

请参考开源项目地址的开源协议

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