视频监控 > API 文档 > 空间管理相关接口 >消息通知

消息通知

最近更新时间：2021-04-15 17:20:53

功能介绍

直播流状态的实时变化、设备状态的实时变化，视频录制/截图成功的通知这类事件都在QVS内部管理，用户可使用QVS的状态回调服务及时获知这些信息。

消息组织格式

使用状态回调服务，您需要在QVS后台配置可正常访问的状态回调URL，回调信息采用JSON格式进行组织，通过HTTP POST协议传递。

流状态回调参数：

参数名称	字段类型	说明
type	string	事件类型，流状态对应事件类型为"stream"
nsId	string	空间ID
streamId	string	流ID
streamState	integer	0: 离线，1：在线
timeSec	integer	对应10位时间戳
reqId	string	请求唯一标识

示例：

curl --request POST \
  --url http://客户自己配置的回调地址 \
  --header 'content-type: application/json' \
  --data '{
	"type": "stream",
	"nsId": "d102sni9zryu",
	"streamId": "31011500991320000137",
	"streamState": 1,
	"timeSec": 1606810185,
	"reqId": "mjgBAHjcY6cbhkwW"
}'

设备状态回调参数:

参数名称	字段类型	说明
type	string	事件类型，流状态对应事件类型为"device"
nsId	string	空间ID
gbid	string	国标ID
chGbid	string	通道ID
deviceState	string	设备状态 “online”/“offline”
timeSec	integer	对应10位时间戳
reqId	string	请求唯一标识

示例：

curl --request POST \
  --url http://客户自己配置的回调地址 \
  --header 'content-type: application/json' \
  --data '{
	"type": "device",
	"nsId": "d102sni9zryu",
	"gbid": "54020000001110000001",
	"chGbid": "31011500991320000096",
	"deviceState": "online"
	"timeSec": 1606810285,
	"reqId": "9H4AAKscvcSXiUwW"
}'

录制状态回调参数:

参数名称	字段类型	说明
type	string	事件类型，流状态对应事件类型为"record"
nsId	string	空间ID
streamId	string	流ID
start	integer	录制开始时间
end	integer	录制结束时间
duration	integer	录制时长
fname	string	录制文件名
recordType	integer	1:实时录制,2:按需录制
code	integer	状态码0成功，1等待处理，2正在处理，3处理失败
errmsg	string	错误信息
timeSec	integer	对应10位时间戳
reqId	string	请求唯一标识

示例：

curl --request POST \
  --url http://客户自己配置的回调地址 \
  --header 'content-type: application/json' \
  --data '{
	"type": "record",
	"nsId": "2akras1jotpfe",
	"streamId": "teststream",
	"start": 1607310997732,
	"end": 1607311044166,
	"duration": 46434,
	"fname": "record/2akras1jotpfe/teststream/1607310997732-1607311044166-44478"
	"recordType": 1,
	"code": 0,
	"errmsg": "",
	"timeSec": 1607311045,
	"reqId": "5AMAADto6DDhUE4W"
}'

截图状态回调参数:

参数名称	字段类型	说明
type	string	事件类型，流状态对应事件类型为"snap"
nsId	string	空间ID
streamId	string	流ID
fname	string	截图文件名
code	integer	状态码0成功，1等待处理，2正在处理，3处理失败
errmsg	string	错误信息
timeSec	integer	对应10位时间戳
reqId	string	请求唯一标识

示例：

curl --request POST \
  --url http://客户自己配置的回调地址 \
  --header 'content-type: application/json' \
  --data '{
	"type": "snap",
	"nsId": "2akras1jotpfe",
	"streamId": "teststream",
	"fname": "snapshot/jpg/2akras1jotpfe/teststream/1607311542082.jpg"
	"code": 0,
	"errmsg": "",
	"timeSec": 1607311552,
	"reqId": "TxcAAAmEzkBWUU4W"
}'

国标报警回调参数:

参数名称	字段类型	说明
type	string	事件类型，取值"alarm"
nsId	string	空间ID
gbid	string	国标ID
chGbid	string	通道ID
deviceState	string	设备状态 “online”/“offline”
timeSec	integer	报警时间，单位秒
alarmMethod	integer	报警方式：1为电话报警， 2为设备报警， 3为短信报警， 4为GPS报警， 5为视频报警， 6为设备故障报警， 7其他报警
alarmType	integer	报警类型,详见`报警类型说明`
alarmPriority	integer	报警级别。取值：1(一级警情),2(二级警情),3(三级警情),4(四级警情)
reqId	string	请求唯一标识

报警类型说明

报警方式（alarmMethod）为2时，
不携带alarmType为默认的报警设备报警；
携带alarmType取值及对应报警类型：1-视频丢失报警； 2-设备防拆报警； 3-存储设备磁盘满报警； 4-设备高温报警； 5-设备低温报警。
报警方式（alarmMethod）为5时，
取值如下：1-人工视频报警； 2-运动目标检测报警； 3-遗留物检测报警； 4-物体移除检测报警； 5-绊线检测报警；6-入侵检测报警； 7-逆行检测报警； 8-徘徊检测报警； 9-流量统计报警； 10-密度检测报警； 11-视频异常检测报警； 12-快速移动报警。
报警方式（alarmMethod）为6时，
取值如下： 1-存储设备磁盘故障报警； 2-存储设备风扇故障报警。

示例：

curl --request POST \
  --url http://客户自己配置的回调地址 \
  --header 'content-type: application/json' \
  --data '{
	"type": "alarm",
	"nsId": "2akras1jotpfe",
	"gbid": "54020000001110000001",
        "chGbid": "31011500991320000096",
	"deviceState":"online",
        "alarmMethod":5,
        "alarmType":2,
        "alarmPriority":1,
	"timeSec": 1607311552,
	"reqId": "TxcAAAmEzkBWUU4W"
}'

以上内容是否对您有帮助？