设备网络SDK开发使用手册

NET_VCA_FACESNAP_RESULT

人脸抓拍结果结构体。

struct{
  DWORD                    dwSize;
  DWORD                    dwRelativeTime;
  DWORD                    dwAbsTime;
  DWORD                    dwFacePicID;
  DWORD                    dwFaceScore;
  NET_VCA_TARGET_INFO      struTargetInfo;
  NET_VCA_RECT             struRect;
  NET_VCA_DEV_INFO         struDevInfo;
  DWORD                    dwFacePicLen;
  DWORD                    dwBackgroundPicLen;
  BYTE                     bySmart;
  BYTE                     byAlarmEndMark;
  BYTE                     byRepeatTimes;
  BYTE                     byUploadEventDataType;
  NET_VCA_HUMAN_FEATURE    struFeature;
  float                    fStayDuration;
  char                     sStorageIP[16];
  WORD                     wStoragePort;
  WORD                     wDevInfoIvmsChannelEx;
  BYTE                     byRes1[15];
  BYTE                     byBrokenNetHttp;
  BYTE                     *pBuffer1;
  BYTE                     *pBuffer2;
}NET_VCA_FACESNAP_RESULT, *LPNET_VCA_FACESNAP_RESULT;

Members

dwSize: 结构体大小
dwRelativeTime: 相对时标
dwAbsTime: 绝对时标
dwFacePicID: 人脸图ID，用于人脸跟踪时产生轨迹，像行为分析一样保存在码流信息里面有播放库去解析并显示轨迹
dwFaceScore: 人脸评分，范围：0~100
struTargetInfo: 报警目标信息
struRect: 人脸子图区域
struDevInfo: 前端设备信息
dwFacePicLen: 人脸子图的长度，为0表示没有图片，大于0表示有图片
dwBackgroundPicLen: 背景图的长度，为0表示没有图片，大于0表示有图片(保留)
bySmart: 0- iDS设备返回（默认值），1- SMART设备返回
byAlarmEndMark: 报警结束标记：0- 保留，1- 结束标记（该字段结合人脸ID字段使用，表示该ID对应的下报警结束，用于判断报警结束，提取识别图片数据中，清晰度最高的图片）
byRepeatTimes: 重复报警次数：0-无意义
byUploadEventDataType: 人脸图片数据长传方式：0-二进制数据，1-URL
struFeature: 人体属性
fStayDuration: 停留画面中时间（单位：秒）
sStorageIP: 存储服务IP地址
wStoragePort: 存储服务端口号
wDevInfoIvmsChannelEx: 与NET_VCA_DEV_INFO里的byIvmsChannel含义相同，能表示更大的值。老客户端用byIvmsChannel能继续兼容，但是最大到255。新客户端版本请使用wDevInfoIvmsChannelEx
byRes1: 保留
byBrokenNetHttp: 断网续传标志位：0-非重传数据，1-重传数据
*pBuffer1: 人脸子图的图片数据
*pBuffer2: 背景图的图片数据

Remarks

人脸抓拍摄像机一般只上传背景图（dwBackgroundPicLen、pBuffer2）和人脸子图区域（struRect），人脸子图需要应用层根据区域从背景图截取。而人脸分析仪(iVMS6200/F)一般只上传人脸子图（dwFacePicLen、pBuffer1）和人脸子图ID（dwFacePicID），背景图需要根据人脸子图ID通过接口NET_DVR_FindBackgroundPic获取。

从绝对时标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_RESULT

Members

Remarks

See Also