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

配置依赖

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

  1. 下载UniApp插件包,解压到项目中的nativePlugins目录下。nativePlugins目录
  2. 导入本地插件。
    1. manifest.json文件下,单击App原生插件配置
    2. App原生插件配置区域,单击选择本地插件导入本地插件
    3. 本地插件选择对话框,选择需要打包生效的插件。
  3. 配置基座包。
    1. 设置自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器 > 运行基座选择,选择自定义调试基座(Android)自定义调试基座
    2. 制作自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器,选择制作自定义调试基座制作自定义调试基座
  4. 调用实人认证服务。
    1. 获取metaInfo数据。
      您在调用刷脸认证服务端发起认证请求时(具体请参见 发起认证请求)需要传入该值。
    2. 开始认证。调用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 刷脸成功 代表刷脸成功,该结果仅供参考。您可通过服务端查询认证结果接口(具体请参见InitFaceVerify)获取最终认证结果。
1001 系统错误 表示系统错误。
1003 验证中断 表示验证中断。
2002 网络错误 表示网络错误。
2003 客户端设备时间错误 表示客户端设备时间错误。
2006 刷脸失败 表示刷脸失败。如需获取更详细的失败原因,需调用服务端查询认证结果接口获取(具体请参见InitFaceVerify)。