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

背景信息

目前UniApp插件只支持iOS端接入。

接入UniApp插件

您可以参考以下步骤接入UniApp插件,或者参见DCloud官网文档接入UniApp插件。详细信息,请参见DCloud官网文档

  1. 打开需要集成实人认证的UniApp工程。
  2. 下载UniApp插件包,解压到UniApp工程中的nativePlugins目录下。导入
  3. 替换安全加密图片。
    1. 登录实人认证管理控制台
    2. 在左侧导航栏,单击接入设置
    3. 接入设置页面,单击获取认证SDK
    4. 认证SDK生成对话框中,单击上传应用,选择您的应用文件进行上传。
    5. 上传完毕后,单击下载认证SDK认证SDK生成
      下载完成后,在下载的文件中获取yw_1222_0769.jpg图片。
    6. 在需要集成实人认证的UniApp工程中,将yw_1222_0769.jpg图片替换UniApp插件包中iOS目录下的yw_1222_0769(测试图片,需要替换成你下载的图片).jpg替换
  4. 导入本地插件。
    1. 打开需要集成实人认证的UniApp工程,在manifest.json文件下,单击App原生插件配置
    2. App原生插件配置区域,单击本地插件导入本地插件
    3. 本地插件选择对话框,选择需要打包生效的插件。
  5. 制作自定义基座包。
    1. manifest.json文件下,选择运行 > 运行到手机或模拟器 > 运行基座选择 > 自定义调试基座(iOS),设置自定义调试基座。自定义调试基座
    2. manifest.json文件下,选择运行 > 运行到手机或模拟器 > 制作自定义调试基座,制作自定义调试基座。制作定义调试基座

调用实人认证

  1. 执行以下命令,获取Module插件。
    var bioDetectModule = uni.requireNativePlugin("RP-FaceDetectPlugin")
  2. 执行以下命令,调用实人认证。
    // 接口1:H5唤起方式。
          bioDetectModule.startWithVerifyToken({
                  'verifyToken': this.verifyToken
              },
              (ret) => {
      this.resultMsg = '结果:' + 'state: ' +ret.state + ' errorCode: ' +ret.errorCode + ' message:' +ret.message
                  uni.showToast({
                      title:'调用startWithVerifyToken方法' + '\nstate' +ret.state + '\nerrorCode' +ret.errorCode + '\nmessage' +ret.message,
                      icon: "none"
                  })
              }
          )
    
    // 接口2:Native唤起方式。
    
      bioDetectModule.startByNativeWithVerifyToken({
              'verifyToken': this.verifyToken
          },
          (ret) => {
          this.resultMsg = '结果:' + 'state: ' +ret.state + ' errorCode: ' +ret.errorCode + ' message:' +ret.message
    
              uni.showToast({
                  title:'调用startByBative方法' + '\nstate' +ret.state + '\nerrorCode' +ret.errorCode + '\nmessage' +ret.message,
                  icon: "none"
              })
          }
      )

错误码说明

在实人认证JavaScript回调的ret中可获取到认证状态和认证失败错误码。

State ErrorCode Message
1 1 认证通过。
2 取值2~12 表示认证不通过。关于认证不通过的具体原因,请参见认证状态说明
-1 -2 未完成认证。原因:网络请求失败,场景与调用接口不符或者接入错误。
-1 未完成认证。原因:用户在认证过程中,主动退出。
3001 未完成认证。原因:认证Token无效或已过期。
3101 未完成认证。原因:用户姓名身份证实名校验不匹配。
3102 未完成认证。原因:实名校验身份证号不存在。
3103 未完成认证。原因:实名校验身份证号不合法。
3104 未完成认证。原因:认证已通过,重复提交。
3203 未完成认证。原因:设备不支持。
3204 未完成认证。原因:非本人操作。
3206 未完成认证。原因:非本人操作。
3208 未完成认证。原因:公安网无底照。