detection.face.detected（人脸比对）

detection.face.detected：人脸比对

detection.face.detected · 通道级 · 消息查询权限 Alarm

功能详情

人脸比对触发时上报。上报报文里 msgType 等于 detection.face.detected。收这条推送需要订阅 capabilityEvent。实时推送和拉取收到的就是本页这条上报报文，见接收告警。

上报字段说明

outputData 内字段。平台字段见接收告警。

参数名	说明	类型	必填	取值
`id`	人脸库Id。	`text`	否	字符串
`faces`	人脸属性列表。最多 100 条。	`array`	否	最多 `100` 条
`snapFace`	抓拍人脸。	`struct`	否	结构体
`candidates`	比对候选人。最多 100 条。	`array`	否	最多 `100` 条
`isDuplicateRemove`	是否去重。	`text`	否	字符串
`address`	抓拍地址。	`text`	否	字符串
`passerby`	路人库。含 uid、groupId、groupName。	`struct`	否	含 `uid`、`groupId`、`groupName`
`passerby.uid`	路人标识。	`text`	否	字符串
`passerby.groupId`	路人库Id。	`text`	否	字符串
`passerby.groupName`	路人库名称。	`text`	否	字符串
`ptzInfo`	PTZ 信息。含 presetNumber、presetName。	`struct`	否	含 `presetNumber`、`presetName`
`ptzInfo.presetNumber`	预置点号。范围 0～999999，步长 1。	`int`	否	`0`～`999999`，步长 `1`
`ptzInfo.presetName`	预置点名称。	`text`	否	字符串

样例

{
  "msgType": "detection.face.detected",
  "deviceId": "TESTIPC000012345",
  "productId": "56WGTET2",
  "channelId": "0",
  "outputData": {
    "id": "example",
    "faces": [],
    "snapFace": {},
    "candidates": [],
    "isDuplicateRemove": "example",
    "address": "example",
    "passerby": {
      "uid": "example",
      "groupId": "example",
      "groupName": "example"
    },
    "ptzInfo": {
      "presetNumber": 0,
      "presetName": "example"
    }
  },
  "time": 1673406989,
  "localTime": "20230111T111629",
  "alarmId": "116257862023505xxxx",
  "token": "f2dc8c09eeae4b5bad6abf522c93d825",
  "thumbUrl": "https://example.imou.com/pic/thumb.jpg",
  "picUrlArray": [
    "https://example.imou.com/pic/frame1.jpg",
    "https://example.imou.com/pic/frame2.jpg"
  ]
}

最小权限

管理员操作自己绑定的设备不需要权限。操作被分享设备需要报警消息权限。子用户绑定不需要。子账号需要 Alarm。见权限码。list / search 按条过滤无权事件。人脸识别。