更新记录

1.3.3(2021-03-03)

修复deviceInfo序列化失败得问题

1.3.2(2021-02-18)

修复onDetectFinish逻辑判断不严谨问题

1.3.0(2021-02-04)

修改插件调用方式 详情参考readme

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.1 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 14

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


产品介绍

支持IOS/Android, 提供多种活体认证方式(静默活体,炫彩活体,动作活体),对人进行认证,用户体验极佳,可用于人脸登录,刷脸支付,刷脸认证等场景,如下:

插件对外接口

如下:

初始化:init()

/**
 * 认证初始化
 * @return JSONObject 包括如下字段
 *    code: 执行结果状态码
 *        FACEID_SUCCESS:执行成功
 *        FACEID_INVALID_PARAM:传入的参数异常
 *        FACEID_EXCEPTION:发生异常
 *    msg: 执行结果描述
 *    data 执行返回结果
 */
JSONObject eFaceIDModule.verifyInit()

发起认证:void startVerify(JSONObject options, final JSCallback callback)

/**
 * 认证初始化
 * @param options,入参 {"token":""}
 * @param callback: 执行完成回调,传入一个对象,包括如下字段
 *    code: 执行结果状态码
 *        FACEID_SUCCESS:执行成功
 *        FACEID_FAILED: 执行失败
 *        FACEID_PERMISSION:无法获得用户授权(camera以及写文件权限)
 *        FACEID_INVALID_PARAM:传入的参数异常
 *        FACEID_EXCEPTION:发生异常
 *    msg: 执行结果描述
 *    token: 认证token
 *    data 执行返回结果
 *    file data数据的文件存储路径(源数据,data是此数据的base64字符串)
 * @return void
 */
void eFaceIDModule.startVerify(JSONObject options, final JSCallback callback)

获取活体视频数据:JSONObject getLivenessVideo(String decryptionKey)

/**
 * 认证初始化
 * @param decryptionKey,解密视频文件的密钥(认证完成后从服务器端返回)
 * @return JSONObject 包括如下字段
 *    code: 执行结果状态码
 *        FACEID_SUCCESS:执行成功
 *        FACEID_FAILED: 执行失败
 *        FACEID_PERMISSION:无法获得用户授权(camera以及写文件权限)
 *        FACEID_INVALID_PARAM:传入的参数异常
 *        FACEID_EXCEPTION:发生异常
 *    msg: 执行结果描述
 *    token: 认证token
 *    data 活体视频数据(base64字符串)
 *    file data数据的文件存储路径(源数据,data是此数据的base64字符串)
 */
JSONObject eFaceIDModule.getLivenessVideo(String decryptionKey)

DEMO

伪代码

如下

# 初始化
ret = eFaceIDModule.verifyInit()
# 服务器端初始化
rspMsg = sendToServer(ret)
# 发起刷脸认证操作
ret = eFaceIDModule.startVerify(rspMsg.token)
# 获取活体检测及刷脸认证结果
rspMsg = sendToServer(ret)
# 获取活体视频(可选)
ret = eFaceIDModule.getLivenessVideo(rspMsg.decryptionKey)

其他信息

  1. 完整接入文档:https://esandinfo.yuque.com/books/share/1b12aca9-d3d6-4011-ac9c-d379c84b71ab?#
  2. 服务器端协议文档:https://market.aliyun.com/products/57000002/cmapi00042648.html#sku=yuncode3664800001
  3. 后端管理控制台地址: http://openali.esandcloud.com
  4. 技术支持
    微信:esand_info
    qq: 3626921591
    电话:18033076802
    邮箱:ruide.li@esandinfo.com

隐私、权限声明

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

"android.permission.CAMERA", "android.permission.INTERNET", "android.permission.ACCESS_NETWORK_STATE", "android.permission.RECORD_AUDIO", "android.permission.RECORD_VIDEO", "android.permission.WRITE_EXTERNAL_STORAGE", "android.permission.ACCESS_WIFI_STATE", "android.permission.MODIFY_AUDIO_SETTINGS", "android.permission.READ_PHONE_STATE"

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

欢迎使用我们的服务并与北京一砂信息技术有限公司共同签署本协议。 您在购买流程中点击同意本协议之前,应当认真阅读本协议。请您务必审慎阅读、充分理解各条款内容,特别是免除或者限制责任的条款、法律适用和争议解决条款。如您对协议有任何疑问,可向我们的客服咨询。 当您阅读并同意本协议且完成付费后,即表示您已充分阅读、理解并接受本协议的全部内容,并与我们达成一致,成为相关产品或服务的“用户”。阅读本协议的过程中,如果您不同意本协议或其中任何条款约定,您应立即停止购买程序。 本协议中,您将被称为“甲方”,我们,即北京一砂信息技术有限公司将被称为“乙方”。 鉴于: 1、甲方需要使用乙方提供的身份识别校验软件产品及配套服务。 2、乙方愿意应甲方的需求提供该等软件产品及配套服务 依据《中华人民共和国协议法》及其他相关法律、法规之规定及政策要求,甲乙双方本着平等、自愿、互利的原则,经友好协商一致,达成如下协议条款,以资遵守: 诚信缔约承诺 双方均是经工商管理机构正式注册备案并合法存续,且已经取得必要业务服务资质,各类证照齐全的合法企业。双方具有签署本协议的合法主体资格,且双方承诺在签署本协议时,各方均无任何法律障碍和重大事件能够导致影响其继续正常存续或有效履行本协议的潜在风险存在。 甲乙双方承诺:如在签订本协议过程中及本协议随后的执行过程中,任何一方发生影响本协议有效执行的变化,均应及时通知协议相对方,否则可视为违约。这些变化包括但不限于:经营资质或备案变化、抵押质押、重大资产变化或债务信息、破产清算、因行业监管要求而被处罚信息、以及其它影响本协议生效或有效执行的各种信息。 甲乙双方承诺:双方的合作应该严格遵守国家及主管部门制定的各类法律、法规及政策。包括但不限于现行的或不时更新、出台的各类法律、法规及政策。 第二条合作内容 本协议所指的“产品”系乙方“一砂数字身份服务平台[简称:eDIS]V1.0”及配套服务的组件之一,具体名称、功能及价格以相关阿里云服务市场购买页面所展示的信息为准。 甲方知晓并同意,乙方产品的安装、部署实施、调试、系统集成以及相关的售后技术服务和维保等工作应由乙方负责。甲方违反本条要求造成产与/或配套服务不可用的,无论是否对甲方造成损失,乙方概不负责,且乙方有权拒绝提供进一步的维保服务。 甲方认可并同意,除为了实现本协议目

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

许可协议

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

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