金融级实人认证服务提供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进行认证。
      参数说明如下表所示。
      名称 类型 描述
      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