消息通知
功能介绍
直播流状态的实时变化、设备状态的实时变化,视频录制/截图成功的通知这类事件都在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"
}'
文档反馈
(如有产品使用问题,请提交工单)