物聯網邊緣計算,為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。