设备网络SDK开发使用手册

NET_VCA_FACESNAP_INFO_ALARM

人脸抓拍信息结构体。

struct{
  DWORD             dwRelativeTime;    
  DWORD             dwAbsTime; 
  DWORD             dwSnapFacePicID; 
  DWORD             dwSnapFacePicLen; 
  NET_VCA_DEV_INFO  struDevInfo; 
  BYTE              byFaceScore; 
  BYTE              bySex; 
  BYTE              byGlasses; 
  BYTE              byAge; 
  BYTE              byAgeDeviation; 
  BYTE              byAgeGroup; 
  BYTE              byRes1[2]; 
  DWORD             dwUIDLen; 
  BYTE              *pUIDBuffer; 
  BYTE              byRes[4]; 
  BYTE              *pBuffer1; 
}NET_VCA_FACESNAP_INFO_ALARM, *LPNET_VCA_FACESNAP_INFO_ALARM;

Members

dwRelativeTime: 相对时标
dwAbsTime: 绝对时标
dwSnapFacePicID: 抓拍人脸图ID
dwSnapFacePicLen: 抓拍人脸子图的长度，为0表示没有图片，大于0表示有图片
struDevInfo: 前端设备信息
byFaceScore: 人脸评分，指人脸子图的质量的评分，取值范围：0~100
bySex: 性别：0- 未知，1- 男，2- 女
byGlasses: 是否带眼镜：0- 未知，1- 是，2- 否
byAge: 年龄
byAgeDeviation: 年龄误差值，如byAge为15且byAgeDeviation为1，则表示实际人脸图片年龄的为14~16之间
byAgeGroup: 年龄段，详见枚举类型：HUMAN_AGE_GROUP_ENUM
byRes1: 保留
dwUIDLen: 上传报警的标识长度
pUIDBuffer: 缓冲区指针，存放上传报警的标识信息，信息相同表示同一次报警上传的结果
byRes: 保留
pBuffer1: 抓拍人脸子图的图片数据

Remarks

人脸比对的匹配图片有多张的时候，多次回调分配获取每一张图片，通过该结构体里面的dwUIDLen和pUIDBuffer判断是否是同一次比对结果，当接收到同一个pUIDbuffer的报警匹配图片的张数等于byMatchPicNum(NET_VCA_FACESNAP_MATCH_ALARM结构体中的参数)时，表示这个报警的匹配图片信息接收结束。如果在一段时间内接收到的匹配图片的张数不等于byMatchPicNum时，上层应该设置一个超时时间，不再继续等待这个报警后续的匹配信息，建议超时时间1分钟。dwUIDLen为0时则不做匹配处理。
从绝对时标dwAbsTime解析得到“年月日时分秒”的算法如下所示：
#define GET_YEAR(_time_)          (((_time_)>>26) + 2000)
#define GET_MONTH(_time_)    (((_time_)>>22) & 15)
#define GET_DAY(_time_)           (((_time_)>>17) & 31)
#define GET_HOUR(_time_)        (((_time_)>>12) & 31)
#define GET_MINUTE(_time_)     (((_time_)>>6) & 63)
#define GET_SECOND(_time_)    (((_time_)>>0) & 63)

NET_VCA_FACESNAP_INFO_ALARM

Members

Remarks

See Also