3.10.1.3.1.      人脸检测

一、功能描述

·                                 快速检测人脸并返回人脸框位置,输出人脸150个关键点坐标,准确识别多种属性信息

二、属性

基本

·                                 显示名称:活动的显示名称。

输入

·                                 APIKey您的APIKey

·                                 SecretKey您的SecretKey

·                                 Image图像类型:要进行处理的图像,仅支持Image类型。如果设置了此属性,则忽略输入项中的文件路径属性。

·                                 文件路径:图像的完整路径以及名称。如果设置了此属性,请忽略输入项中的Image图像类型属性。

输出

·                                 结果图片的识别结果,仅支持Newtonsoft.Json.Linq.JObject类型。

选项

·                                 人脸区域:包括age,beauty,expression,face_shape,gender,glasses,landmark,landmark72landmark150race,quality,eye_status,emotion,face_type信息,逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度

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

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

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

·                                 活体检测控制:活体检测控制NONE:不进行控制LOW:较低的活体要求(高通过率低攻击拒绝率)NORMAL:一般的活体要求(平衡的攻击拒绝率,通过率)HIGH:较高的活体要求(高攻击拒绝率低通过率)默认NONE

三、具体步骤
1、关于如何取得APIKeySecretKey,请参考4.2.6如何调用百度云OCR

2、在使用此组件时,需要输入图片路径或是Image类型图像,同时需要创建一个JObject类型的变量用于接收输出结果,输出结果参数详情如下:

字段

必选

类型

说明

face_num

int

检测到的图片中的人脸数量

face_list

array

人脸信息列表,具体包含的参数参考下面的列表。

+face_token

string

人脸图片的唯一标识

+location

array

人脸在图片中的位置

++left

double

人脸区域离左边界的距离

++top

double

人脸区域离上边界的距离

++width

double

人脸区域的宽度

++height

double

人脸区域的高度

++rotation

int64

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

+face_probability

double

人脸置信度,范围【0~1】,代表这是一张人脸的概率,0最小、1最大。

+angel

array

人脸旋转角度参数

++yaw

double

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

++pitch

double

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

++roll

double

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

+age

double

年龄 ,当face_field包含age时返回

+beauty

int64

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

+expression

array

表情,当 face_field包含expression时返回

++type

string

none:不笑;smile:微笑;laugh:大笑

++probability

double

表情置信度,范围【0~1】,0最小、1最大。

+face_shape

array

脸型,当face_field包含face_shape时返回

++type

double

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

++probability

double

置信度,范围【0~1】,代表这是人脸形状判断正确的概率,0最小、1最大。

+gender

array

性别,face_field包含gender时返回

++type

string

male:男性 female:女性

++probability

double

性别置信度,范围【0~1】,0代表概率最小、1代表最大。

+glasses

array

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

++type

string

none:无眼镜,common:普通眼镜,sun:墨镜

++probability

double

眼镜置信度,范围【0~1】,0代表概率最小、1代表最大。

+eye_status

array

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

++left_eye

double

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

++right_eye

double

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

+emotion

array

情绪 face_field包含emotion时返回

++type

string

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

++probability

double

情绪置信度,范围0~1

+race

array

人种 face_field包含race时返回

++type

string

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

++probability

double

人种置信度,范围【0~1】,0代表概率最小、1代表最大。

+face_type

array

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

++type

string

human: 真实人脸 cartoon: 卡通人脸

++probability

double

人脸类型判断正确的置信度,范围【0~1】,0代表概率最小、1代表最大。

+landmark

array

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

+landmark72

array

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

+landmark150

array

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

+quality

array

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

++occlusion

array

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

+++left_eye

double

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

+++right_eye

double

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

+++nose

double

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

+++mouth

double

嘴巴遮挡比例,[0-1] 1表示完全遮挡

+++left_cheek

double

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

+++right_cheek

double

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

+++chin

double

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

++blur

double

人脸模糊程度,范围[0~1]0表示清晰,1表示模糊

++illumination

double

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

++completeness

int64

人脸完整度,01, 0为人脸溢出图像边界,1为人脸都在图像边界内