swan.ai.facePersonVerify

基础库 3.20.11 开始支持，低版本需做兼容处理。

解释：公安验证，基于姓名和身份证号，调取公民身份证小图（源自公安系统），将当前获取的人脸图片，与此证件小图进行对比，得出比对分数。使用本功能需要小程序开发者后台登录超级管理员账号，点击云平台付费链接swan.ai.facePersonVerify - 图1开通云账号付费功能。

方法参数

Object object

object参数说明 ：

属性名类型必填默认值说明
imagestring是图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。
image_typestring是图片类型· BASE64 :图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过 2M；· URL :图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)；· FACE_TOKEN : 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个。
id_card_numberstring是身份证号码
namestring是姓名
quality_controlstring否图片质量控制。· NONE : 不进行控制；· LOW :较低的质量要求；· NORMAL : 一般的质量要求；· HIGH : 较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败。
liveness_controlstring否活体检测控制。· NONE : 不进行控制；· LOW :较低的活体要求(高通过率 低攻击拒绝率)；· NORMAL : 一般的活体要求(平衡的攻击拒绝率, 通过率)；· HIGH : 较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败。
successFunction否接口调用成功后的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数名参数类型说明
log_idNumber日志 ID
scorenumber与公安小图相似度可能性，用于验证生活照与公安小图是否为同一人，有正常分数时为 [0~100]，推荐阈值 80，超过即判断为同一人。

示例

在开发者工具中预览效果

swan.ai.facePersonVerify - 图2请使用百度APP扫码

图片示例

swan.ai.facePersonVerify - 图3

swan.ai.facePersonVerify - 图4

swan.ai.facePersonVerify - 图5

代码示例

  1. Page({
  2.     facePersonVerify() {
  3.         // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
  4.         let host = swan.getSystemInfoSync().host;
  5.         if (host === 'baiduboxapp') {
  6.             swan.ai.facePersonVerify({
  7.                 image: 'https://www.downloadImage.com/xxxx.jpg',
  8.                 image_type: 'URL',
  9.                 quality_control: 'NONE',
  10.                 liveness_control: 'NONE',
  11.                 id_card_number: '',
  12.                 name: '',
  13.                 success: res => {
  14.                     console.log('success', res);
  15.                 },
  16.                 fail: err => {
  17.                     console.log('fail', err);
  18.                 }
  19.             });
  20.         }
  21.         else {
  22.             swan.showToast({
  23.                 title: '此api目前仅可在百度App上使用',
  24.                 icon: 'none'
  25.             });
  26.         }
  27.     }
  28. });

返回示例

  1. {
  2.   "score": 44.3,
  3. }