物联网边缘计算,为V系列边缘一体机(下文简称边缘一体机)提供人脸底库服务API。通过人脸底库服务API,您可以创建、查看、删除、更新人脸底库服务的用户、用户组、设备组等,也可以管理用户、用户组、设备组之间的关联关系。
人脸同步机制
物联网边缘计算提供的人脸同步机制如下:
一个人脸用户,可以加入一个或多个用户组。
一个边缘一体机,可以加入一个或多个设备组。
用户组和设备组之间,可以绑定或解绑人脸同步关系。
重要绑定或解绑用户组和设备组的人脸同步关系,会触发大量设备数据的同步,建议不要轻易变更人脸同步关系。
如下图以工厂人脸识别场景为例,展示人脸同步机制。
上图中:
管理组内每个人的人脸底库,会同步到会议室设备组、仓库设备组和大门设备组的每一台边缘一体机上(边缘一体机1、边缘一体机2)。
安保组内每个人的人脸底库,会同步到仓库设备组和大门设备组的每一台边缘一体机上(边缘一体机1、边缘一体机2)。
工人组内每个人的人脸底库,会同步到大门设备组的每一台边缘一体机上(边缘一体机2)。
API调用顺序
添加人脸用户
以下步骤中:
步骤1至步骤3,在同一个人脸项目(例如一个工厂、学校、办公大楼等独立的人脸项目)中,执行一次即可。
步骤4至步骤5,每次添加人脸用户时重复调用。
步骤6,根据您的实际需求进行调用。
创建人脸用户组和设备组:
绑定用户组与设备组之间的人脸同步关系:AddFaceUserGroupAndDeviceGroupRelation。
添加设备到设备组:AddFaceDeviceToDeviceGroup。
添加人脸用户:AddFaceUser。
添加人脸用户到用户组:AddFaceUserToUserGroup。
(可选)为人脸底库中的用户增加一张人脸图片:AddFaceUserPicture。
删除人脸用户
删除单个人脸用户:
调用RemoveFaceUserFromUserGroup,从用户组中移除指定用户。
调用DeleteFaceUser,从人脸底库中删除指定的用户。
删除多个人脸用户,有如下两种情况:
调用QueryFaceAllUserIdsByGroupId,获取用户组中所有人脸用户ID后,循环调用DeleteFaceUser,删除目标人脸用户。
调用DeleteFaceUserGroup,删除用户组,即可删除用户组内所有用户。
删除人脸用户的指定人脸图片:DeleteFaceUserPicture。
删除指定边缘一体机上的所有人脸信息,API调用顺序如下:
调用QueryFaceDeviceGroupsByDevice,查询边缘一体机已关联的所有设备组。
循环调用RemoveFaceDeviceFromDeviceGroup,将边缘一体机从每个设备组中移除。
人脸同步异常处理
如果出现云端和设备端的人脸底库不一致时,可通过调用ClearFaceDeviceDB,清空边缘一体机的所有人脸底库,触发人脸数据的重新同步。
重新同步人脸数据时,受网络等环境因素,会耗时较久,因此请不要频繁调用ClearFaceDeviceDB。