行為監(jiān)控事件接口描述文檔_1903
接口描述文檔
1. 事件通知接口
1.1 描述
當(dāng)有事件觸發(fā)的時(shí)候，通過 HTTP Server Sent Events 協(xié)議，推送事件。
1.2 調(diào)用說明
項(xiàng)目 | 描述 |
接口名稱 | notifications |
請求方式 | GET |
URL | http://ip:8234/api/v1/events/notifications |
1.3 返回結(jié)果
1.3.1 Keep Alive
服務(wù)器每個(gè)一段時(shí)間會(huì)發(fā)送 Keep Alive 消息，以保持連接長時(shí)間聯(lián)通。
返回內(nèi)容如下：
: keepAlive
1.3.2 evStart
事件觸發(fā)時(shí)，首先會(huì)發(fā)出 evStart 事件，提示已有新事件觸發(fā)。
返回內(nèi)容示例如下：
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 內(nèi)容如下：
字段 | 描述 |
eId | 事件唯一的 id |
cId | 攝像機(jī) id |
cName | 攝像機(jī)名稱 |
types | 包含的事件類型： HAS_PEOPLE：闖入事件 MEN_DOWN：倒地事件 HANDS_UP：求救事件 HAS_CROWD：聚眾事件 HAS_FIGHT：打架事件 HAS_CLIMB：攀爬事件 |
time | 事件時(shí)間戳 |
1.3.3 evUpdate
有事件動(dòng)作和坐標(biāo)更新時(shí)，會(huì)發(fā)出 evUpdate 事件
返回內(nèi)容示例如下：
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 內(nèi)容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 攝像機(jī) id |
cName | 攝像機(jī)名稱 |
types | 包含的事件類型 |
time | 事件時(shí)間戳 |
objects | 觸發(fā)事件的目標(biāo)位置信息 |
objects 內(nèi)容如下：
字段 | 描述 |
class | 目標(biāo)類型，有以下類型： HumanPose 人體目標(biāo) |
meta | 目標(biāo)元信息，包含： type：觸發(fā)事件類型 maxScore：事件置信度，取值范圍 [0,10)
|
box | 目標(biāo)邊界信息： x：目標(biāo)在畫面的左上角 x 坐標(biāo)，單位為畫面寬度的百分比 y：目標(biāo)再畫面的左上角 y 坐標(biāo)，單位為畫面高度的百分比 w： 目標(biāo)邊界的寬度，單位為畫面寬度的百分比 h：目標(biāo)邊界的高度，單位為畫面高度的百分比 |
1.3.4 evSnap
事件觸發(fā)的截圖保存成功時(shí)，發(fā)出該事件
返回內(nèi)容示例如下：
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 內(nèi)容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 攝像機(jī) id |
cName | 攝像機(jī)名稱 |
types | 包含的事件類型 |
time | 事件時(shí)間戳 |
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 | 觸發(fā)事件的目標(biāo)位置信息 |
event.json 文件包含人體骨架信息，actPeople 內(nèi)容如下：
字段 | 描述 |
model | 識別模型類別 |
x | 識別畫面像素寬度 |
y | 識別畫面像素高度 |
rEye | 右眼坐標(biāo)信息 |
lEye | 左眼坐標(biāo)信息 |
rEar | 右眼坐標(biāo)信息 |
lEar | 左眼坐標(biāo)信息 |
nose | 鼻子坐標(biāo)信息 |
neck | 脖子坐標(biāo)信息 |
rShoulder | 右肩膀坐標(biāo)信息 |
lShoulder | 左肩膀坐標(biāo)信息 |
rElbow | 右手肘坐標(biāo)信息 |
lElbow | 左手肘坐標(biāo)信息 |
rWrist | 右手腕坐標(biāo)信息 |
lWrist | 左手腕坐標(biāo)信息 |
rHip | 臀部右側(cè)坐標(biāo)信息 |
midHip | 臀部中點(diǎn)坐標(biāo)信息 |
lHip | 臀部左側(cè)坐標(biāo)信息 |
rKnee | 右膝蓋坐標(biāo)信息 |
lKnee | 左膝蓋坐標(biāo)信息 |
rAnkle | 右腳腕坐標(biāo)信息 |
lAnkle | 左腳腕坐標(biāo)信息 |
rHeel | 右腳腳后跟坐標(biāo)信息 |
lHeel | 左腳腳后跟坐標(biāo)信息 |
rBigToe | 右腳大腳趾坐標(biāo)信息 |
lBigToe | 左腳大腳趾坐標(biāo)信息 |
rSmallToe | 右腳小腳趾坐標(biāo)信息 |
lSmallToe | 左腳小腳趾坐標(biāo)信息 |
坐標(biāo)信息內(nèi)容如下：
字段 | 描述 |
x | 以畫面左上角為原點(diǎn)，向右為正方向，水平坐標(biāo) |
y | 以畫面左上角為原點(diǎn)，向下為正方向，垂直坐標(biāo) |
score | 精確度，取值范圍為 [0,10)，取值為 0 時(shí)，表示沒有識別 |
1.3.5 evVideo
事件觸發(fā)的視頻保存成功時(shí)，發(fā)出該事件
返回內(nèi)容示例如下：
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 內(nèi)容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 攝像機(jī) id |
cName | 攝像機(jī)名稱 |
time | 事件時(shí)間戳 |
types | 包含的事件類型 |
videoPath | 視頻路徑，獲取視頻的示例如下： http://ip:8234/0/2019/03/10/16/59.07.618/0000.mp4 |
1.3.6 evEnd
事件結(jié)束時(shí)，發(fā)出該事件
返回內(nèi)容示例如下：
event: evEnd
data: {"eId":"9ed84802-f53a-49cc-a240-9a15b5600ad0","cId":"0","cName":"Camera","id":"a3a528a5-16cf-4ed0-9d8d-54375555db1d","types":[],"time":1552208348668}
data 內(nèi)容如下：
字段 | 描述 |
eId | 事件的 id |
cId | 攝像機(jī) id |
cName | 攝像機(jī)名稱 |
types | 包含的事件類型 |
time | 事件時(shí)間戳 |
