faceSearch

解释：人脸搜索，传入人脸图片，支持在指定人脸图片集合中，找到与传入图片中人脸最为相似的图片。

最低支持版本 3.20.11 。方法参数：ObjectObject 参数说明：
参数名参数类型是否必填说明
imagestring是图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。
image_typestring是图片类型· BASE64:图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过2M；· URL:图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)；· FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个。
group_id_liststring是从指定的 group 中进行查找 用逗号分隔，上限 10 个。
quality_controlstring否图片质量控制。· NONE: 不进行控制；· LOW:较低的质量要求；· NORMAL: 一般的质量要求；· HIGH: 较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败。
liveness_controlstring否活体检测控制。· NONE: 不进行控制；· LOW:较低的活体要求(高通过率 低攻击拒绝率)；· NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率)；· HIGH: 较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败。
max_face_numstring否最多处理人脸的数目，默认值为1，仅检测图片中面积最大的那个人脸；最大值10，检测图片中面积最大的几张人脸。
user_idstring否当需要对特定用户进行比对时，指定user_id进行比对。即人脸认证功能。
successFunction否接口调用成功后的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

返回值参数说明

参数名参数类型说明
face_tokenstring人脸标志
user_listArray匹配的用户信息列表

user_list参数说明

参数名参数类型说明
group_idstring用户所属的 group_id
user_idArray用户的 user_id
user_infoArray注册用户时携带的 user_info
scorenumber用户的匹配得分，推荐阈值 80 分。

示例代码

  1. swan.chooseImage({
      success(res) {
        let image = res.tempFilePaths[0];
        swan.ai.faceSearch({
            image,
            image_type: 'BASE64',
            quality_control: 'NONE',
            liveness_control: 'NONE',
            face_type: 'LIVE',
            user_id: 'xxxxxx',
            max_user_num: 20,
            success(res) {
                console.log('success', res);
            },
            fail(err) {
                console.warn('fail', err);
            }
        });
      }
    });

返回示例

  1. {
        "face_token": "fid",
        "user_list": [  
           {
              "group_id" : "test1",
              "user_id": "u333333",
              "user_info": "Test User",
              "score": 99.3  
          }
        ]
      }