行為監控事件接口描述文檔_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 | 事件時間戳 |