更新记录

1.0.0(2021-01-07)

1.0.0版本发布。预告:下一个版提供服务端unicloud版示例!


平台兼容性

Android iOS
适用版本区间:6.0 - 11.0 支持CPU类型: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原生插件配置”->”云端插件“列表中删除该插件重新选择


刷脸认证提供UniApp插件,帮助您在App中实现刷脸认证功能。您可通过刷脸认证的服务端认证初始化接口,获取刷脸认证的唯一标识CertifyId,并使用CertifyId唤起刷脸认证客户端SDK。本文介绍了UniApp客户端接入的操作方法。

配置依赖

参考以下步骤接入UniApp插件,或者您也可以参见DCloud官网文档接入UniApp插件。

  1. 下载UniApp插件包,解压到项目中的nativePlugins目录下。nativePlugins目录

  2. 导入本地插件。

    • 在manifest.json文件下,单击App原生插件配置。
    • 在App原生插件配置区域,单击选择本地插件。导入本地插件
    • 在本地插件选择对话框,选择需要打包生效的插件。
  3. 配置基座包

    • 设置自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器 > 运行基座选择,选择自定义调试基座(Android)。自定义调试基座
    • 制作自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器,选择制作自定义调试基座。制作自定义调试基座
  4. 调用实人认证服务

    • 获取metaInfo数据。
    • 您在调用刷脸认证服务端发起认证请求时(具体请参见发起认证请求)需要传入该值。
    • 开始认证。调用verify接口,传入certifyId进行认证。

参数说明如下表所示

名称 类型 描述
certifyId string 认证的唯一标识。
returnVideo string 是否返回视频(iOS)
取值:true:返回视频
false(默认):不返回视频
ext_params_key_use_video string 是否返回视频(Android)
取值:true:返回视频
false(默认):不返回视频
ext_params_key_ocr_bottom_button_color string OCR底部按钮的默认颜色
ext_params_key_ocr_bottom_button_clicked_color string OCR底部按钮被操作时的颜色
ext_params_key_ocr_face_circle_color string 实人认证进度条颜色

接入示例:

<template>
</template>
<script>
const n = uni.requireNativePlugin('AP-FaceDetectModule');
export default {
    methods: {
        verifyC: function() {
            n.verify(
                {
                    certifyId: this.certify
                },
                function(t) {
                    uni.showToast({
                        title: '返回的内容' + t,
                        icon: 'none'
                    });
                }
            );
        },
        //获取环境参数接口。
        getMetaInfo: function() {
            var t = n.getMetaInfo();

        },
    }
};
</script>

错误码说明

错误码 错误码文案 错误码描述
1000 刷脸成功 代表刷脸成功,该结果仅供参考。您可通过服务端查询认证结果接口(具体请参见查询认证结果)获取最终认证结果。
1001 系统错误 表示系统错误。
1003 验证中断 表示验证中断。
2002 网络错误 表示网络错误。
2003 客户端设备时间错误 表示客户端设备时间错误。
2006 刷脸失败 表示刷脸失败。如需获取更详细的失败原因,需调用服务端查询认证结果接口获取(具体请参见查询认证结果)。

隐私、权限声明

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

摄像头和本地存储

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

本插件自身不采集收集用户数据。 使用的是阿里云实人认证sdk,采集人脸,并提交到阿里云完成实名认证和活体检测。具体见阿里云官网介绍https://help.aliyun.com/document_detail/99173.html

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

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