视频监控

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

    消息通知

    最近更新时间:2020-12-08 16:20:03

    功能介绍

    直播流状态的实时变化、设备状态的实时变化,视频录制/截图成功的通知这类事件都在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"
    }'
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close