行为监控事件接口描述文档_1903
接口描述文档
1. 事件通知接口
1.1 描述
当有事件触发的时候，通过 HTTP Server Sent Events 协议，推送事件。
1.2 调用说明
项目 | 描述 |
接口名称 | notifications |
请求方式 | GET |
URL | http://ip:8234/api/v1/events/notifications |
1.3 返回结果
1.3.1 Keep Alive
服务器每个一段时间会发送 Keep Alive 消息，以保持连接长时间联通。
返回内容如下：
: keepAlive
1.3.2 evStart
事件触发时，首先会发出 evStart 事件，提示已有新事件触发。
返回内容示例如下：
event: evStart
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"f6f81925-edcb-4e36-af74-faa4421928a1","types":["HANDS_UP","HAS_PEOPLE"],"time":1552208347618}
data 内容如下：
字段 | 描述 |
eId | 事件唯一的 id |
cId | 摄像机 id |
cName | 摄像机名称 |
types | 包含的事件类型： HAS_PEOPLE：闯入事件 MEN_DOWN：倒地事件 HANDS_UP：求救事件 HAS_CROWD：聚众事件 HAS_FIGHT：打架事件 HAS_CLIMB：攀爬事件 |
time | 事件时间戳 |
1.3.3 evUpdate
有事件动作和坐标更新时，会发出 evUpdate 事件
返回内容示例如下：
event: evUpdate
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"db28d1c2-2d4a-417c-a8d7-5b8b635f0b15","types":["HANDS_UP","HAS_PEOPLE"],"time":1552208347623,"objects":[{"class":"HumanPose","meta":{"type":"HANDS_UP","maxScore":0.856761},"box":{"x":0.754315090625,"y":0.20239317222222222,"w":0.058036803124999994,"h":0.1875871444444444}},{"class":"HumanPose","meta":{"type":"HAS_PEOPLE","maxScore":0.856761,"sumScore":10.843880000000002,"avgScore":0.6024377777777778,"partCnt":18},"box":{"x":0.754315090625,"y":0.20239317222222222,"w":0.058036803124999994,"h":0.1875871444444444}},{"class":"HumanPose","meta":{"type":"HAS_PEOPLE","maxScore":0.323736,"sumScore":2.397319,"avgScore":0.19977658333333334,"partCnt":12},"box":{"x":0.5433637140625,"y":0.4471094333333333,"w":0.07340321562500005,"h":0.21725523333333333}}]}
data 内容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 摄像机 id |
cName | 摄像机名称 |
types | 包含的事件类型 |
time | 事件时间戳 |
objects | 触发事件的目标位置信息 |
objects 内容如下：
字段 | 描述 |
class | 目标类型，有以下类型： HumanPose 人体目标 |
meta | 目标元信息，包含： type：触发事件类型 maxScore：事件置信度，取值范围 [0,10)
|
box | 目标边界信息： x：目标在画面的左上角 x 坐标，单位为画面宽度的百分比 y：目标再画面的左上角 y 坐标，单位为画面高度的百分比 w： 目标边界的宽度，单位为画面宽度的百分比 h：目标边界的高度，单位为画面高度的百分比 |
1.3.4 evSnap
事件触发的截图保存成功时，发出该事件
返回内容示例如下：
event: evSnap
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"f13d827f-3323-427a-a788-cc9fee0f7f07","types":["HANDS_UP","HAS_PEOPLE"],"time":1552208347626,"snapPath":"/0/2019/03/10/16/59.07.618/snap.jpg","evJsonPath":"/0/2019/03/10/16/59.07.618/event.json","objects":[{"class":"HumanPose","meta":{"type":"HANDS_UP","maxScore":0.856761,"sumScore":10.843880000000002,"avgScore":0.6024377777777778,"partCnt":18},"box":{"x":0.754315090625,"y":0.20239317222222222,"w":0.058036803124999994,"h":0.1875871444444444}},{"class":"HumanPose","meta":{"type":"HAS_PEOPLE","maxScore":0.856761,"sumScore":10.843880000000002,"avgScore":0.6024377777777778,"partCnt":18},"box":{"x":0.754315090625,"y":0.20239317222222222,"w":0.058036803124999994,"h":0.1875871444444444}},{"class":"HumanPose","meta":{"type":"HAS_PEOPLE","maxScore":0.323736,"sumScore":2.397319,"avgScore":0.19977658333333334,"partCnt":12},"box":{"x":0.5433637140625,"y":0.4471094333333333,"w":0.07340321562500005,"h":0.21725523333333333}}]}
data 内容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 摄像机 id |
cName | 摄像机名称 |
types | 包含的事件类型 |
time | 事件时间戳 |
snapPath | 截图路径，获取截图的示例如下： http://ip:8234/0/2019/03/10/16/59.07.618/snap.jpg |
evJsonPath | 事件额外信息文件路径，连接如下： http://ip:8234/0/2019/03/10/16/59.07.618/event.json |
objects | 触发事件的目标位置信息 |
event.json 文件包含人体骨架信息，actPeople 内容如下：
字段 | 描述 |
model | 识别模型类别 |
x | 识别画面像素宽度 |
y | 识别画面像素高度 |
rEye | 右眼坐标信息 |
lEye | 左眼坐标信息 |
rEar | 右眼坐标信息 |
lEar | 左眼坐标信息 |
nose | 鼻子坐标信息 |
neck | 脖子坐标信息 |
rShoulder | 右肩膀坐标信息 |
lShoulder | 左肩膀坐标信息 |
rElbow | 右手肘坐标信息 |
lElbow | 左手肘坐标信息 |
rWrist | 右手腕坐标信息 |
lWrist | 左手腕坐标信息 |
rHip | 臀部右侧坐标信息 |
midHip | 臀部中点坐标信息 |
lHip | 臀部左侧坐标信息 |
rKnee | 右膝盖坐标信息 |
lKnee | 左膝盖坐标信息 |
rAnkle | 右脚腕坐标信息 |
lAnkle | 左脚腕坐标信息 |
rHeel | 右脚脚后跟坐标信息 |
lHeel | 左脚脚后跟坐标信息 |
rBigToe | 右脚大脚趾坐标信息 |
lBigToe | 左脚大脚趾坐标信息 |
rSmallToe | 右脚小脚趾坐标信息 |
lSmallToe | 左脚小脚趾坐标信息 |
坐标信息内容如下：
字段 | 描述 |
x | 以画面左上角为原点，向右为正方向，水平坐标 |
y | 以画面左上角为原点，向下为正方向，垂直坐标 |
score | 精确度，取值范围为 [0,10)，取值为 0 时，表示没有识别 |
1.3.5 evVideo
事件触发的视频保存成功时，发出该事件
返回内容示例如下：
event: evVideo
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"f13d827f-3323-427a-a788-cc9fee0f7f07","time":1552208353623,"types":["HANDS_UP","HAS_PEOPLE"],"videoPath":"/0/2019/03/10/16/59.07.618/0000.mp4"}
data 内容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 摄像机 id |
cName | 摄像机名称 |
time | 事件时间戳 |
types | 包含的事件类型 |
videoPath | 视频路径，获取视频的示例如下： http://ip:8234/0/2019/03/10/16/59.07.618/0000.mp4 |
1.3.6 evEnd
事件结束时，发出该事件
返回内容示例如下：
event: evEnd
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"a3a528a5-16cf-4ed0-9d8d-54375555db1d","types":[],"time":1552208348668}
data 内容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 摄像机 id |
cName | 摄像机名称 |
types | 包含的事件类型 |
time | 事件时间戳 |