人脸识别打卡项目(2)

实际应用中,姿态变化是另外一个影响人脸识别性能重要的因素。姿态问题涉及头部在三维垂直坐标系中绕三个轴的旋转造成的面部变化，其中垂直于图像平面的两个方向的深度旋转会造成面部信息的部分缺失，使得姿态问题成为人脸识别的一个技术难题。在使用过程中，可通过表中所示的返回结果的Pitch、 Roll、Yaw字段判断姿态角度情况。

5 人脸完整度

人脸完整度主要是检测采集到的人脸是否溢出图像边界，不完整的人脸图像，往往得不到的识别结果。可通过返回结果的completeness字段判断完整度情况，取值为0或1，0为人脸溢出图像边界，1为人脸都在图像边界内。推荐数值视业务逻辑判断。

6 人脸大小

图像采集过程中，人脸距离摄像头的远近，会直接影响采集到的人脸大小，人脸过小或过大，都会影响识别效果。根据返回结果的长宽进行判断，如表所示。

2 人脸库管理介绍

简单来讲，人脸库就是人脸数据的储存管理中心，能够为人脸识别提供比对模板，为抓拍人脸数据提供管理空间，为人脸算法检测提供测试样本。人脸识别项目是建立在人脸库的基础之上，所以人脸识别的首要任务便是是建立人脸库。

人脸库按照用途可分为人脸比对库、人脸抓拍库、人脸数据集，如图所示，不同类型人脸库的组成、结构、作用也有所不同，本章节主要介绍人脸比对库。

人脸比对库主要用于人脸1：N识别，如下图，人脸1:N是将人脸抓拍照片的人脸特征与人脸库中所有人脸特征进行逐一比对。人脸识别过程主要包括以下四个步骤：

1. 输入人脸

2. 计算人脸特征

3. 逐一从库中获取人脸特征

4. 对比人脸特征

如图所示。

人脸比对库主要由人脸库管理、人脸数据、人脸库属性描述三部分组成，如图所示。

我们介绍了人脸库的基础内容，包括人脸库支持的接口及其功能、人脸库的结构等。本章节将重点介绍各接口的使用方法，帮助我们实现对人脸库的管理。

1 人脸注册

人脸注册是向人脸库中添加人脸数据，接口地址为https://aip.baidubce.com/rest/2.0/face/v3/faceset/ user/add，人脸注册完毕后，生效时间一般为5s以内，之后便可以进行人脸搜索或认证等操作。其请求参数如表所示。

返回参数含义如表所示。

返回示例：

{
    "face_token": "2fa64a88a9d5118916f9a303782a97d3",
    "location": {
    "left": 117,
    "top": 131,
    "width": 172,
    "height": 170,
    "rotation": 4
    }
}

2 人脸更新

人脸更新用于对人脸库中指定用户，更新其下的人脸图像。针对一个user_id执行更新操作，新上传的人脸图像将覆盖此 user_id 原有所有图像。接口地址为 https://aip.baidubce.com/rest/2.0/face/v3/facese t/user/update，其请求参数和返回参数与人脸注册相关参数一致，可参照表和表所示内容。

返回示例：

{
    "face_token": "2fa64a88a9d5118916f9a303782a97d3",
    "location": {
    "left": 117,
    "top": 131,
    "width": 172,
    "height": 170,
    "rotation": 4
    }
}

3 人脸删除

人脸删除用于删除用户的某一张人脸，如果该用户只有一张人脸图片，则同时删除用户。接口地址为htt ps://aip.baidubce.com/rest/2.0/face/v3/faceset/face/delete，其请求参数如表所示。

可通过返回的error_code判断是否成功，如失败则查看error_msg获得具体错误信息。返回示例：

// 删除成功
{
    "error_code": 0,
    "log_id": 73473737,
}
// 删除发生错误
{
    "error_code": 223106,
    "log_id": 1382953199,
    "error_msg": "face is not exist"
}

4 用户信息查询

用户信息查询主要用于获取人脸库中某个用户的信息(user_info信息和用户所属的组)。请求地址为http s://aip.baidubce.com/rest/2.0/face/v3/faceset/user/get，其请求参数如表所示。

返回参数含义如表所示。

返回示例：

{
    "user_list": [
        {
            "user_info": "user info ...",
            "group_id": "gid1"
        },
        {
            "user_info": "user info2 ...",
            "group_id": "gid2"
        }
    ]
}

5 获取用户人脸列表

获取用户人脸列表主要用于获取一个用户的全部人脸列表。接口地址为https://aip.baidubce.com/rest/ 2.0/face/v3/faceset/face/getlist，其请求参数如表所示。

返回参数的含义如表所示。

返回示例：

{
"face_list": [
{
"face_token": "fid1",
"ctime": "2018-01-01 00:00:00"
},
{
"face_token": "fid2",
"ctime": "2018-01-01 10:00:00"
}
]
}

6 获取用户列表

取用户列表用于查询指定用户组中的用户列表。接口地址为https://aip.baidubce.com/rest/2.0/face/ v3/faceset/group/getusers ，其请求参数如表所示。

返回参数含义如表所示。

返回示例：

{
"user_id_list":
[ "uid1",
"uid2"
]
}

7 复制用户

复制用户用于将已经存在于人脸库中的用户复制到一个新的组。这个过程并不是向一个指定组内添加用户，而是直接从其它组复制用户信息如果需要注册用户，需要直接使用人脸注册接口。接口地址为http s://aip.baidubce.com/rest/2.0/face/v3/faceset/user/copy，其请求参数如表所示。

可以通过返回结果中的error_code字段来判断是否成功，如失败则查看error_msg获得具体错误信息。返回示例：

// 正确返回值
{
"error_code": 0,
"log_id": 3314921889,
}
// 发生错误时返回值
{
"error_code": 223111,
"log_id": 3111284097,
"error_msg": "dst group is not exist"
}

8 删除用户

删除用户用于将用户从某个组中删除。接口地址为https://aip.baidubce.com/rest/2.0/face/v3/faceset/ user/delete，其请求参数如表所示。

通过返回结果中的error_code判断是否成功，如失败则查看error_msg获得具体错误信息，返回参数含义如表所示。

返回示例：

// 正确返回值
{
"error_code": 0,
"log_id": 3314921889,
}
// 发生错误时返回值
{
"error_code": 223103,
"log_id": 815967402,
"error_msg": "user is not exist"
}

9 创建用户组

创建用户组用于创建一个空的用户组，如果用户组已存在则返回错误。接口地址为https://aip.baidubc e.com/rest/2.0/face/v3/faceset/group/add，其请求参数如表所示。

通过返回结果中的error_code判断是否成功，如失败则查看error_msg获得具体错误信息，返回参数含义如表所示。

返回示例：

// 正确返回值
{
"error_code": 0,
"log_id": 3314921889,
}
// 发生错误时返回值
{
"error_code": 223101,
"log_id": 815967402,
"error_msg": " group is already exist"
}

10 删除用户组

此接口用于删除用户组下所有的用户及人脸，如果组不存在则返回错误。需要说明的是当组内的人脸数量如果大于500条，会在后台异步进行删除。在删除期间，无法向该组中添加人脸。1秒钟可以删除20条记录，相当于一小时可以将7万人的人脸组删除干净。接口地址为https://aip.baidubce.com/rest/2.0/fa ce/v3/faceset/group/delete，其请求参数如表所示。

通过返回结果中的error_code判断是否成功，如失败则查看error_msg获得具体错误信息，返回参数含义如表所示。

返回示例：

// 正确返回值
{
"error_code":0,
"log_id": 3314921889,
}
// 发生错误时返回值
{
"error_code": 223100,
"log_id": 815967402,
"error_msg": " group is not exist"
}

11 组列表查

组列表查询主要用于查询用户组的列表。接口地址为https://aip.baidubce.com/rest/2.0/face/v3/faces et/group/getlist，其请求参数如表所示。

返回参数含义如表所示。

返回示例：

{
"group_id_list":
[ "gid1",
"gid2"
]
}

总结

本节课我们学习了人脸图像质量检测，人脸库管理介绍的相关内容。下节课我们将学习数据库结构介绍的相关内容。我会带着大家一起完成人脸识别打卡项目的所有内容。

DAMO开发者矩阵

DAMO开发者矩阵，由阿里巴巴达摩院和中国互联网协会联合发起，致力于探讨最前沿的技术趋势与应用成果，搭建高质量的交流与分享平台，推动技术创新与产业应用链接，围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐

机器人方案降成本前，先把这 7 笔账算清楚

预计单台节省 XX 元。至少应该留下这些结果：要算的账至少说清什么节省基准省哪笔钱、当前基准、数量和周期影响范围改什么、牵动哪些关系一次性投入设计、适配、验证、工装和旧状态处置持续执行每台装配、配置、测试和异常处理的变化质量可靠性已验证风险、未决边界和扩大条件现场维护备件、维修、复装验证和追溯变化成立条件何时抵消投入、怎样回看、何时重评这张表不是为了把所有东西都强行换算成一个绝对精确的数字。它的作