边缘人脸对接指南

该指南仅限于边缘设备对接，相关范围如下：

1、 边缘设备：超脑、人脸客流相机、…；

2、 人脸库/人脸比对库：有普通库和私密库，当前仅支持普通库。

目前接入边缘设备有四部分协议，后续可能扩展，如下图所示：

人脸导入过程分为同步导入和异步导入，同步导入较简单，只有一个接口。异步导入有配合使用的接口，如下图所示：

人脸异步下发过程：

STEP1：预先获取或维护人脸库和人员编号信息；

OPT1：调用【查询人脸库剩余人脸数及磁盘容量】查看人脸库剩余人脸数和磁盘容量信息，避免下发时不必要的异常，如人脸图片已达上限等问题；

STEP2：调用【人脸信息异步批量导入】接口异步导入人脸，该接口将任务送到设备后，返回任务ID；

STEP3：监听【边缘设备人脸异步导入任务消息】获取任务状态，该消息仅在设备将任务处理完成后发出；

OPT2：定时调用【查询单个异步导入任务状态】接口，查询当前任务成功与否，建议该接口在消息接收不到的情况下使用；

STEP4：调用【查询人脸异步任务底图入库状态】接口，获取人脸建模成功与否，失败的返回失败原因；

OPT3：调用【删除人脸异步导入任务】接口删除已经处理完成的任务，避免任务记录长期堆积导致设备内存泄漏或接口报错；

在人脸下发过程中，最好能够通过接收消息的方式获取任务进度或结果，避免频繁调用查询接口。

1、遇到512126和519998错误，其对应的message透传设备错误，可以通过技术支持或分公司人员获取帮助；

2、平台端查询接口限制一般可以兼容大部分型号设备，对于部分设备在查询过程中报错，可以通过缩小查询范围的方式解决；

3、不同类型的设备支持的最大任务数不同，比如超脑支持5个、人脸客流相机支持30个。因此在实际使用过程中，需要及时清理下发完成的任务；