刷脸认证提供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 刷脸成功 代表刷脸成功,该结果仅供参考,可通过服务端查询认证结果获取最终认证结果。
1001 系统错误 表示系统错误。
1003 验证中断 表示验证中断。
2002 网络错误 表示网络错误。
2003 客户端设备时间错误 表示客户端设备时间错误。
2006 刷脸失败 表示刷脸失败,如需获取更详细的失败原因,需调用服务端查询认证结果