百度智能小程序 人脸对比

swan.ai.faceMatch

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

解释：人脸对比，支持两张人脸图片的相似度对比，图片类型可以为：生活照，证件照，身份证芯片照或者带网纹照。使用本功能需要小程序开发者后台登录超级管理员账号，点击 云平台付费链接 开通云账号付费功能。

方法参数

Object object

object 参数说明

属性名	类型	必填	默认值	说明
data	Array	是		图片信息
success	Function	否		接口调用成功后的回调函数
fail	Function	否		接口调用失败的回调函数
complete	Function	否		接口调用结束的回调函数（调用成功、失败都会执行）

data 参数

参数名	参数类型	是否必填	说明
image	String	是	图片信息(总数据大小应小于 10M)，图片上传方式根据 image_type 来判断。
image_type	String	是	图片类型。 · BASE64：图片的 base64 值，base64 编码后的图片数据，编码后的图片大小不超过 2M； · URL：图片的 URL 地址( 可能由于网络等原因导致下载图片时间过长)； · FACE_TOKEN：人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的 FACE_TOKEN，同一张图片多次检测得到的 FACE_TOKEN 是同一个。
quality_control	String	否	图片质量控制。 · NONE：不进行控制； · LOW：较低的质量要求； · NORMAL：一般的质量要求； · HIGH：较高的质量要求；默认 NONE，若图片质量不满足要求，则返回结果中会提示质量检测失败。
liveness_control	String	否	活体检测控制。 · NONE：不进行控制； · LOW：较低的活体要求(高通过率 低攻击拒绝率)； · NORMAL：一般的活体要求(平衡的攻击拒绝率, 通过率)； · HIGH：较高的活体要求(高攻击拒绝率 低通过率)。默认 NONE，若活体检测结果不满足要求，则返回结果中会提示活体检测失败。
face_type	String	否	人脸的类型。 · LIVE 表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等； · IDCARD 表示身份证芯片照：二代身份证内置芯片中的人像照片； · WATERMARK 表示带水印证件照：一般为带水印的小图，如公安网小图； · CERT 表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片；默认 LIVE。

success 返回参数说明

参数名	参数类型	说明
score	Number	人脸相似度得分，推荐阈值 80 分。
face_list	Array	人脸信息列表

face_list 参数说明

参数名	参数类型	说明
face_token	String	人脸的唯一标志

示例 

在开发者工具中打开

图片示例

代码示例

Page({
    faceMatch() {
        // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
        let host = swan.getSystemInfoSync().host;
        if (host === 'baiduboxapp') {
            swan.ai.faceMatch({
                data: [{
                        "image": "https://www.downloadImage.com/xxxx.jpg",
                        "image_type": "URL",
                        "face_type": "LIVE",
                        "quality_control": "LOW",
                        "liveness_control": "HIGH"
                    },
                    {
                        "image": "https://www.downloadImage.com/xxxx.jpg",
                        "image_type": "URL",
                        "face_type": "IDCARD",
                        "quality_control": "LOW",
                        "liveness_control": "HIGH"
                }],
                success: res => {
                    console.log('res');
                },
                fail: err => {
                    console.log('err');
                }
            });
        }
        else {
            swan.showToast({
                title: '此api目前仅可在百度App上使用',
                icon: 'none'
            });
        }
    }
});

返回值示例

{
    "score": 44.3,
    "face_list": [  //返回的顺序与传入的顺序保持一致
        {
            "face_token": "fid1"
        },
        {
            "face_token": "fid2"
        }
    ]
}