视频监控

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

    消息通知

    最近更新时间:2021-05-11 14:59:58

    功能介绍

    直播流状态的实时变化、设备状态的实时变化,视频录制/截图成功的通知这类事件都在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
    snapItems 对象数组 截图结果集
    code integer 状态码0成功,1等待处理,2正在处理,3处理失败
    errmsg string 错误信息
    timeSec integer 对应10位时间戳,回调的时间
    reqId string 请求唯一标识

    snapItem对象参数

    参数名称 字段类型 说明
    fname string 截图结果的外链资源名
    code int 状态码0成功,1等待处理,2正在处理,3处理失败
    error string 如果处理失败,该字段会给出失败的详细原因

    示例:

    curl --request POST \
      --url http://客户自己配置的回调地址 \
      --header 'content-type: application/json' \
      --data '{
    	"type": "snap",
    	"nsId": "2akras1jotpfe",
    	"streamId": "teststream",
    	"snapItems": [{
                "fname": "snapshot/jpg/2akras1jotpfe/teststream/1607311542082.jpg",
                "code": 0,
                "error": ""
            }]
    	"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