文档

概述

更新时间:

物联网边缘计算,为V系列边缘一体机(下文简称边缘一体机)提供人脸底库服务API。通过人脸底库服务API,您可以创建、查看、删除、更新人脸底库服务的用户、用户组、设备组等,也可以管理用户、用户组、设备组之间的关联关系。

人脸同步机制

物联网边缘计算提供的人脸同步机制如下:

  • 一个人脸用户,可以加入一个或多个用户组。

  • 一个边缘一体机,可以加入一个或多个设备组。

  • 用户组和设备组之间,可以绑定或解绑人脸同步关系。

    重要

    绑定或解绑用户组和设备组的人脸同步关系,会触发大量设备数据的同步,建议不要轻易变更人脸同步关系。

如下图以工厂人脸识别场景为例,展示人脸同步机制。

人脸同步机制示意图

上图中:

  • 管理组内每个人的人脸底库,会同步到会议室设备组仓库设备组大门设备组的每一台边缘一体机上(边缘一体机1、边缘一体机2)。

  • 安保组内每个人的人脸底库,会同步到仓库设备组大门设备组的每一台边缘一体机上(边缘一体机1、边缘一体机2)。

  • 工人组内每个人的人脸底库,会同步到大门设备组的每一台边缘一体机上(边缘一体机2)。

API调用顺序

添加人脸用户

重要

以下步骤中:

  • 步骤1至步骤3,在同一个人脸项目(例如一个工厂、学校、办公大楼等独立的人脸项目)中,执行一次即可。

  • 步骤4至步骤5,每次添加人脸用户时重复调用。

  • 步骤6,根据您的实际需求进行调用。

  1. 创建人脸用户组和设备组:

  2. 绑定用户组与设备组之间的人脸同步关系:AddFaceUserGroupAndDeviceGroupRelation

  3. 添加设备到设备组:AddFaceDeviceToDeviceGroup

  4. 添加人脸用户:AddFaceUser

  5. 添加人脸用户到用户组:AddFaceUserToUserGroup

  6. (可选)为人脸底库中的用户增加一张人脸图片:AddFaceUserPicture

删除人脸用户

人脸同步异常处理

如果出现云端和设备端的人脸底库不一致时,可通过调用ClearFaceDeviceDB,清空边缘一体机的所有人脸底库,触发人脸数据的重新同步。

重要

重新同步人脸数据时,受网络等环境因素,会耗时较久,因此请不要频繁调用ClearFaceDeviceDB