UniApp客户端接入

接入前必读

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

配置依赖

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

1. 下载增强版实人认证UniApp SDK，解压到项目中的nativePlugins目录。
2. 导入本地插件。
   1. 在manifest.json文件，单击App原生插件配置。
   2. 在App原生插件配置区域，单击选择本地插件。
   3. 在本地插件选择对话框，选择需要打包生效的插件。
3. 配置基座包。
   1. 设置自定义调试基座。在manifest.json文件，选择运行 > 运行到手机或模拟器 > 运行基座选择 > 自定义调试基座。
   2. 制作自定义调试基座。在manifest.json文件，选择运行 > 运行到手机或模拟器 > 制作自定义调试基座。
4. 调用增强版实人认证服务。
   1. 获取MetaInfo数据。
      您在调用增强版实人认证服务端发起认证请求时需要传入该值。
   2. 开始认证。调用认证接口（faceCompare函数），传入certifyId进行认证（certifyId通过接口InitSmartVerify获取）。
      参数说明如下表所示。

      名称	类型	描述
      certifyId	String	认证的唯一标识。
      extParams	Map<String, String>	用户自定义参数，可以为空。关于自定义的字段，请参见用户自定义参数extParams支持的字段说明。

      表 1. 用户自定义参数extParams支持的字段说明

      名称	描述	示例值
      kIdentityParamKeyShowResult	是否需要展示OCR识别结果确认页。取值： YES：要展示OCR识别结果确认页。 NO：不展示OCR识别结果确认页。	YES
      kIdentityParamKeyWaterMark	自定义证件图片水印文字。默认文字为仅供业务使用。	仅供业务使用
      kIdentityParamKeyIdCardFaceOnly	是否仅识别身份证人像面。取值： YES：仅识别身份证人像面。 NO：识别身份证人像面和国徽面。	NO
      kIdentityParamKeyScanMaxTime	OCR证件扫描的超时时间，单位为秒，默认30秒。	30
      kIdentityParamKeyValidIdCardDate	是否校验身份证有效期。取值： YES：校验身份证有效期。 NO：不校验身份证有效期。 说明 当kIdentityParamKeyIdCardFaceOnly取值为NO时该参数生效。	YES
      kIdentityParamKeyNextButtonColor	OCR识别结果确认页底部按钮的底色。	#FF0000
      kIdentityParamKeyOcrMode	OCR模式。取值： PHOTO（默认）：拍照模式。 SCAN：扫描模式。	PHOTO
      kIdentityParamKeyOcrSelectPhoto	是否展示从相册选择图片的功能，取值： YES（默认）：展示从相册选择照片的功能。 NO：不展示从相册选择照片的功能。	YES

代码示例

• 获取MetaInfo数据：

  <script>
      //加载增强版实人认证插件。
    const verifyPlugin = uni.requireNativePlugin('IdentityPlatformUniPlugin');
    export default {
      onLoad() {
        //调用getMetaInfo获取MetaInfo数据。
        var metaInfo = verifyPlugin.getMetaInfo();
        console.log(metaInfo);
      }
    }
  </script>

• 增强版活体验证服务代码示例：

  verifyPlugin.faceCompare({
          "certifyId":"xxx"    //填写从服务端获取的certifyId。
        }, function(response){
  
        });

  //response返回格式。
  {
     code:1000, //错误码。
     message:认证通过, //错误码描述。
     deviceToken:xxx, //设备Token（如果需要则获取本字段）。
  }

错误码说明