• swan.ai.faceDetect
  • 方法参数
    • object 参数说明
    • success 返回参数说明
    • result 参数说明
    • face_list 参数说明
    • location 返回值说明
    • angel 返回值说明
    • expression 返回值说明
    • face_shape 返回值说明
    • gender 返回值说明
    • glasses 返回值说明
    • eye_status 返回值说明
    • emotion 返回值说明
    • race 返回值说明
    • face_type 返回值说明
    • landmark 返回值说明
    • quality 返回值说明
    • occlusion 返回值说明
  • 示例
    • 图片示例
    • 代码示例 1：image_type 为 BASE64
    • 代码示例 2：image_type 为 URL
    • 代码示例 3：image_type 为 FACE_TOKEN
    • 返回值示例

swan.ai.faceDetect

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

成都创新互联成立于2013年，先为安徽等服务建站，安徽等地企业，进行企业商务咨询服务。为安徽企业网站制作PC+手机+微官网三网同步一站式服务解决您的所有建站问题。

解释：人脸检测，检测图片中的人脸并标记出相应的信息位置，同时可以展示出人脸的关键信息和属性信息，比如年龄，性别等。使用本功能需要小程序开发者后台登录超级管理员账号，点击云平台付费链接开通云账号付费功能。
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 是同一个

face_field

String

否

包括 age、beauty、expression、face_shape、gender、glasses、landmark、race、quality、eye_status、emotion、face_type 信息，逗号分隔。默认只返回 face_token 、人脸框、概率和旋转角度

max_face_num

String

否

1

最多处理人脸的数目，默认值为 1 ，仅检测图片中面积最大的那个人脸；最大值 10 ，检测图片中面积最大的几张人脸

face_type

String

否

LIVE

人脸的类型。有效值：
· LIVE 表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等
· IDCARD 表示身份证芯片照：二代身份证内置芯片中的人像照片
· WATERMARK 表示带水印证件照：一般为带水印的小图，如公安网小图
· CERT 表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片；默认 LIVE

success

Function

否

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

fail

Function

否

接口调用失败的回调函数

complete

Function

否

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

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

success 返回参数说明

log_id

Number

唯一的 log id ，用于问题定位

error_code

Number

错误码，错误码为 0 时，人脸检测成功

error_msg

String

错误描述信息，帮助理解和解决发生的错误

result

Object

人脸属性对象的集合

参数名	参数类型	说明

result 参数说明

face_num

Number

检测到图片中的人脸数量

face_list

Array

人脸信息列表

参数名	参数类型	说明

face_list 参数说明

face_token

String

人脸图片的唯一标识

location

Object

人脸在图片中的位置

face_probability

Number

人脸置信度，范围 [0-1] ，代表这是一张人脸的概率，0：最小、1：最大

angel

Object

人脸旋转角度参数

age

Number

年龄，当 face_field 包含 age 时返回

beauty

Number

美丑打分，范围 [0-100]，越大表示越美，当 face_fields 包含 beauty 时返回

expression

Object

表情，当 face_field 包含 expression 时返回

face_shape

Object

脸型，当 face_field 包含 face_shape 时返回

gender

Object

性别，face_field 包含 gender 时返回

glasses

Object

是否带眼镜，face_field 包含 glasses 时返回

eye_status

Object

双眼状态（睁开/闭合）face_field 包含 eye_status 时返回

emotion

Object

情绪，face_field 包含 emotion 时返回

race

Object

人种 face_field 包含 race 时返回

face_type

Object

真实人脸/卡通人脸 face_field 包含 face_type 时返回

landmark

Object

4 个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_field 包含 landmark 时返回

quality

Object

人脸质量信息，face_field 包含 quality 时返回

参数名	参数类型	说明

location 返回值说明

left

Number

人脸区域离左边界的距离

top

Number

人脸区域离上边界的距离

width

Number

人脸区域的宽度

height

Number

人脸区域的高度

rotation

Number

人脸框相对于竖直方向的顺时针旋转角，[-180,180]

参数名	参数类型	说明

angel 返回值说明

yaw

Number

三维旋转之左右旋转角 [-90(左),90(右)]

pitch

Number

三维旋转之俯仰角度 [-90(上),90(下)]

roll

Number

平面内旋转角 [-180(逆时针),180(顺时针)]

参数名	参数类型	说明

expression 返回值说明

type

String

none：不笑；smile：微笑；laugh：大笑

probability

Number

表情置信度，范围 [0-1] ，0 最小、1 最大

参数名	参数类型	说明

face_shape 返回值说明

type

String

square：正方形；triangle：三角形；oval：椭圆；heart：心形；round：圆形

probability

Number

置信度，范围 [0-1] ，代表这是人脸形状判断正确的概率，0 最小、1 最大

参数名	参数类型	说明

gender 返回值说明

type

String

male：男性；female：女性

probability

Number

性别置信度，范围 [0-1] ，0 代表概率最小、1 代表最大

参数名	参数类型	说明

glasses 返回值说明

type

String

none：无眼镜；common：普通眼镜；sun：墨镜

probability

Number

眼镜置信度，范围 [0-1]，0 代表概率最小、1 代表最大

参数名	参数类型	说明

eye_status 返回值说明

left_eye

Number

左眼状态 [0,1] 取值，越接近 0 闭合的可能性越大

right_eye

Number

右眼状态 [0,1] 取值，越接近 0 闭合的可能性越大

参数名	参数类型	说明

emotion 返回值说明

type

String

angry：愤怒；disgust：厌恶；fear：恐惧；happy：高兴；sad：伤心；surprise：惊讶；neutral：无情绪

probability

Number

情绪置信度，范围 [0-1]

参数名	参数类型	说明

race 返回值说明

type

String

yellow：黄种人；white：白种人；black：黑种人；arabs：阿拉伯人

probability

Number

人种置信度，范围 [0-1] ，0：代表概率最小、1：代表最大

参数名	参数类型	说明

face_type 返回值说明

type

String

human：真实人脸；cartoon：卡通人脸

probability

Number

人脸类型判断正确的置信度，范围 [0-1] ，0：代表概率最小、1：代表最大

参数名	参数类型	说明

landmark 返回值说明

landmark72

Array

72 个特征点位置 face_field 包含 landmark72 时返回

landmark150

Array

150 个特征点位置 face_field 包含 landmark150 时返回

参数名	参数类型	说明

quality 返回值说明

occlusion

Number

人脸各部分遮挡的概率，范围 [0-1] ，0：表示完整，1：表示不完整

blur

Number

人脸模糊程度，范围 [0-1] ，0：表示清晰，1：表示模糊

illumination

Number

取值范围在 [0-255] ，表示脸部区域的光照程度越大表示光照越好

completeness

Number

人脸完整度，0 或 1 ，0：为人脸溢出图像边界，1：为人脸都在图像边界内

参数名	参数类型	说明

occlusion 返回值说明

left_eye

Number

左眼遮挡比例，[0-1] ，1：表示完全遮挡

right_eye

Number

右眼遮挡比例，[0-1] ，1：表示完全遮挡

nose

Number

鼻子遮挡比例，[0-1] ，1：表示完全遮挡

left_cheek

Number

左脸颊遮挡比例，[0-1] ，1：表示完全遮挡

right_cheek

Number

右脸颊遮挡比例，[0-1] ，1：表示完全遮挡

chin

Number

下巴遮挡比例，[0-1] ，1：表示完全遮挡

参数名	参数类型	说明

示例

扫码体验

代码示例

请使用百度APP扫码

图片示例

代码示例 1：image_type 为 BASE64

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

• JS

 
 
 
  
  
  
Page({
  
  
  
 faceDetect() {
  
  
  
 swan.chooseImage({
  
  
  
 success: res => {
  
  
  
 let image = res.tempFilePaths[0];
  
  
  
 // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
  
  
  
 let host = swan.getSystemInfoSync().host;
  
  
  
 if (host === 'baiduboxapp') {
  
  
  
 swan.ai.faceDetect({
  
  
  
 image,
  
  
  
 image_type: 'BASE64',
  
  
  
 face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',
  
  
  
 max_face_num: '1',
  
  
  
 face_type: 'LIVE',
  
  
  
 success: res => {
  
  
  
 console.log(res.face_list);
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 console.log( err);
  
  
  
 }
  
  
  
 });
  
  
  
 }
  
  
  
 else {
  
  
  
 swan.showToast({
  
  
  
 title: '此api目前仅可在百度App上使用',
  
  
  
 icon: 'none'
  
  
  
 });
  
  
  
 }
  
  
  
 }
  
  
  
 })
  
  
  
 }
  
  
  
});
 
 

代码示例 2：image_type 为 URL

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

• JS

 
 
 
  
  
  
Page({
  
  
  
 faceDetect() {
  
  
  
 swan.chooseImage({
  
  
  
 success: res => {
  
  
  
 let image = res.tempFilePaths[0];
  
  
  
 // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
  
  
  
 let host = swan.getSystemInfoSync().host;
  
  
  
 if (host === 'baiduboxapp') {
  
  
  
 swan.ai.faceDetect({
  
  
  
 image:'https://b.bdstatic.com/miniapp/image/faceDetect.png',
  
  
  
 image_type: 'URL',
  
  
  
 face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',
  
  
  
 max_face_num: '1',
  
  
  
 face_type: 'LIVE',
  
  
  
 success: res => {
  
  
  
 console.log(res.face_list);
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 console.log( err);
  
  
  
 }
  
  
  
 });
  
  
  
 }
  
  
  
 else {
  
  
  
 swan.showToast({
  
  
  
 title: '此api目前仅可在百度App上使用',
  
  
  
 icon: 'none'
  
  
  
 });
  
  
  
 }
  
  
  
 }
  
  
  
 })
  
  
  
 }
  
  
  
});
 
 

代码示例 3：image_type 为 FACE_TOKEN

在开发者工具中打开

在开发者工具中打开

在 WEB IDE 中打开

• JS

 
 
 
  
  
  
Page({
  
  
  
 faceDetect() {
  
  
  
 swan.chooseImage({
  
  
  
 success: res => {
  
  
  
 let image = res.tempFilePaths[0];
  
  
  
 // AI系列的api有宿主使用限制,只可在百度App中使用,建议使用时加一层判断防止代码报未知错误
  
  
  
 let host = swan.getSystemInfoSync().host;
  
  
  
 if (host === 'baiduboxapp') {
  
  
  
 swan.ai.faceDetect({
  
  
  
 // 可由之前图片检测的返回值中获得
  
  
  
 image:'4160b708a826b18de95fe5c9a098a436',
  
  
  
 image_type: 'FACE_TOKEN',
  
  
  
 face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',
  
  
  
 max_face_num: '1',
  
  
  
 face_type: 'LIVE',
  
  
  
 success: res => {
  
  
  
 console.log(res.face_list);
  
  
  
 },
  
  
  
 fail: err => {
  
  
  
 console.log( err);
  
  
  
 }
  
  
  
 });
  
  
  
 }
  
  
  
 else {
  
  
  
 swan.showToast({
  
  
  
 title: '此api目前仅可在百度App上使用',
  
  
  
 icon: 'none'
  
  
  
 });
  
  
  
 }
  
  
  
 }
  
  
  
 })
  
  
  
 }
  
  
  
});
 
 

返回值示例

• JSON

 
 
 
  
  
  
{
  
  
  
 "face_num": 1,
  
  
  
 "face_list": [
  
  
  
 {
  
  
  
 "face_token": "35235asfas21421fakghktyfdgh68bio",
  
  
  
 "location": {
  
  
  
 "left": 117,
  
  
  
 "top": 131,
  
  
  
 "width": 172,
  
  
  
 "height": 170,
  
  
  
 "rotation": 4
  
  
  
 },
  
  
  
 "face_probability": 1,
  
  
  
 "angle" :{
  
  
  
 "yaw" : -0.34859421849251
  
  
  
 "pitch" 1.9135693311691
  
  
  
 "roll" :2.3033397197723
  
  
  
 }
  
  
  
 "landmark": [
  
  
  
 {
  
  
  
 "x": 161.74819946289,
  
  
  
 "y": 163.30244445801
  
  
  
 },
  
  
  
 ...
  
  
  
 ],
  
  
  
 "landmark72": [
  
  
  
 {
  
  
  
 "x": 115.86531066895,
  
  
  
 "y": 170.0546875
  
  
  
 }，
  
  
  
 ...
  
  
  
 ],
  
  
  
 "age": 29.298097610474,
  
  
  
 "beauty": 55.128883361816,
  
  
  
 "expression": {
  
  
  
 "type": "smile",
  
  
  
 "probability" : 0.5543018579483
  
  
  
 },
  
  
  
 "gender": {
  
  
  
 "type": "male",
  
  
  
 "probability": 0.99979132413864
  
  
  
 },
  
  
  
 "glasses": {
  
  
  
 "type": "sun",
  
  
  
 "probability": 0.99999964237213
  
  
  
 },
  
  
  
 "race": {
  
  
  
 "type": "yellow",
  
  
  
 "probability": 0.99999976158142
  
  
  
 },
  
  
  
 "face_shape": {
  
  
  
 "type": "triangle",
  
  
  
 "probability": 0.5543018579483
  
  
  
 }
  
  
  
 "quality": {
  
  
  
 "occlusion": {
  
  
  
 "left_eye": 0,
  
  
  
 "right_eye": 0,
  
  
  
 "nose": 0,
  
  
  
 "mouth": 0,
  
  
  
 "left_cheek": 0.0064102564938366,
  
  
  
 "right_cheek": 0.0057411273010075,
  
  
  
 "chin": 0
  
  
  
 },
  
  
  
 "blur": 1.1886881756684e-10,
  
  
  
 "illumination": 141,
  
  
  
 "completeness": 1
  
  
  
 }
  
  
  
 }
  
  
  
 ]
  
  
  
}
 
 

分享名称：创新互联百度小程序教程：swan.ai.faceDetect
浏览路径：http://www.jxjierui.cn/article/ccsisss.html