视频监控

  • 视频监控 > 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"
    }'
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close