detection.face.detected（人脸比对）

detection.face.detected：人脸比对

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

功能详情

人脸比对触发时上报。上报报文里 msgType 等于 detection.face.detected。在 callbackFlag 中订阅 capabilityEvent。见接收设备消息、setMessageCallback、事件专页、概述与公共负载。

上报字段说明

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。列表/检索按条过滤无权事件。人脸识别。