后浪云百度小程序教程：swan.ai.facePersonVerify

2023-9-8
  • swan.ai.facePersonVerify
    • 方法参数
      • object 参数说明
      • success 返回参数说明
    • 示例
      • 图片示例
      • 代码示例
      • 返回值示例

    swan.ai.facePersonVerify

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

    解释：公安验证，基于姓名和身份证号，调取公民身份证小图（源自公安系统），将当前获取的人脸图片，与此证件小图进行对比，得出比对分数。使用本功能需要小程序开发者后台登录超级管理员账号，点击云平台付费链接开通云账号付费功能。
    Web 态说明：受宿主环境限制，Web 态暂不支持 AI 能力相关接口。在 Web 态会做 打开百度 App 对应小程序页面 的降级处理。

    方法参数

    Object object

    object 参数说明

    属性名 类型 必填 默认值 说明

    image

    String

    是

    图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。注意：
    · 图片尺寸建议：1920 * 1080 以内
    · 支持格式：支持 jpg、jpeg、png、bmp，不支持 gif 图

    image_type

    String

    是

    图片类型
    · BASE64：图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过 2M
    · URL：图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)
    · FACE_TOKEN：人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个

    id_card_number

    String

    是

    身份证号码

    name

    String

    是

    姓名

    quality_control

    String

    否

    图片质量控制。
    · NONE：不进行控制
    · LOW：较低的质量要求；
    · NORMAL：一般的质量要求
    · HIGH：较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败

    liveness_control

    String

    否

    活体检测控制。
    · NONE：不进行控制
    · LOW：较低的活体要求(高通过率 低攻击拒绝率)
    · NORMAL：一般的活体要求(平衡的攻击拒绝率，通过率)
    · HIGH：较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败

    success

    Function

    否

    接口调用成功后的回调函数

    fail

    Function

    否

    接口调用失败的回调函数

    complete

    Function

    否

    接口调用结束的回调函数（调用成功、失败都会执行）

    success 返回参数说明

    参数名 参数类型 说明

    log_id

    Number

    日志 ID

    score

    Number

    与公安小图相似度可能性，用于验证生活照与公安小图是否为同一人，有正常分数时为 [0~100]，推荐阈值 80，超过即判断为同一人

    示例

    跳转编辑工具

    在开发者工具中打开

    在 WEB IDE 中打开

    扫码体验

    代码示例

    后浪云百度小程序教程：swan.ai.facePersonVerify插图

    请使用百度APP扫码

    图片示例

    后浪云百度小程序教程：swan.ai.facePersonVerify插图1

    代码示例

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

    返回值示例

    • JSON
     
 
 
      
  
  
  
    1. {
      2. 
  
  
  
    2.  "score": 44.3,
      3. 
  
  
  
    3. }
      4.
    版权声明：
    作者：后浪云
    链接：https://www.idc.net/help/186600/
    文章版权归作者所有，未经允许请勿转载。
    THE END
    IDC.NET智能小程序后浪云百度小程序
    Copyright © 2025 后浪云 网站地图