金融级实人认证服务提供UniApp插件,帮助您在您的业务应用(App)中实现刷脸认证功能。您可以通过您的应用服务端认证初始化接口,向阿里云服务器调用发起认证请求接口并获取刷脸认证的唯一标识CertifyId,然后使用CertifyId唤起刷脸认证客户端SDK。本文介绍如何通过UniApp插件接入刷脸认证。

接入前必读

近期发现有个人开发者封装阿里云增强版实人认证SDK后开发了第三方插件,并在某平台上提供付费下载服务。阿里云提醒您,如果您使用了此类非阿里云官方提供的插件或服务,阿里云概不对由此造成的一切后果负责,亦不承担任何法律责任。建议您使用阿里云官方SDK服务。

配置依赖

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

  1. 下载金融级实人认证UniApp SDK,解压到项目中的nativePlugins目录下。nativePlugins目录
  2. 导入本地插件。
    1. manifest.json文件下,单击App原生插件配置
    2. App原生插件配置区域,单击选择本地插件导入本地插件
    3. 本地插件选择对话框,选择需要打包生效的插件。
  3. 配置基座包。
    1. 设置自定义调试基座。在manifest.json文件,选择运行 > 运行到手机或模拟器 > 运行基座选择 > 自定义调试基座(Android)自定义调试基座
    2. 制作自定义调试基座。在manifest.json文件,单击运行 > 运行到手机或模拟器,选择制作自定义调试基座制作自定义调试基座
  4. 调用实人认证服务。
    1. 获取metaInfo数据。
      您在调用刷脸认证服务端发起认证请求时需要传入该值。具体操作,请参见发起认证请求
    2. 调用verify接口,传入certifyId进行认证。
      参数说明如下表所示。
      名称类型描述
      certifyIdString认证的唯一标识。
      returnVideoString是否返回视频(iOS)。取值:
      • true:返回视频。
      • false(默认):不返回视频。
      returnVideoUploadString是否需要将返回视频上传到OSS(iOS)。取值:
      • true:上传视频。
      • false(默认):不上传视频。
      ext_params_key_use_videoString是否返回视频并上传到OSS(Android)。取值:
      • true:返回并上传视频。
      • false(默认):不返回视频。
      ext_params_key_ocr_bottom_button_colorStringOCR底部按钮的默认颜色。
      ext_params_key_ocr_bottom_button_clicked_colorStringOCR底部按钮被操作时的颜色。
      ext_params_key_ocr_face_circle_colorString实人认证进度条颜色。
      说明 表中的参数均为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刷脸成功代表刷脸成功,该结果仅供参考,可通过调用服务端DescribeFaceVerify接口获取最终认证结果。
1001系统错误表示系统错误。
1003验证中断表示验证中断。
2002网络错误表示网络错误。
2003客户端设备时间错误表示客户端设备时间错误。
2006刷脸失败表示刷脸失败,如需获取更详细的失败原因,需调用服务端DescribeFaceVerify接口获取。