视频监控-流状态回调使用说明

最近更新时间: 2020-12-09 11:29:12

1.如何触发流状态回调？空间中需要配置回调地址，这是前提条件。具体操作如下

通过api创建或者更新空间的客户，可以填充callBack字段，该字段就是回调地址，例如该字段形式为 www.qiniu.com/callback 或者 11.11.11.11:8888/callback
用户也可以通过视频监控(qvs)的官方控制台，在portal中，添加回调地址(后续的portal版本会添加对流状态回调的支持)

2.触发回调的时机和格式？

在流连接和断开时，会分别触发回调
回调的格式，采用http post请求。body采用json编码，并固定以下几个字段，根据实际情况会调整，并保持兼容。

{
  "type": "stream"          // 回调类型
	"nsId": "xx",            // 空间id, (字符串类型)
	"streamId": "xx",        // 流id， (字符串类型)
	"streamState": 1,        // 0:流断开 1:流连接, (整型)
	"timeSec": xx,   // streamState为0,代表流断开的时间戳；streamState为1,代表流连接的时间戳，(整型)
	"reqId": "xx" //唯一标示，(字符串类型)
}

视频监控(qvs)回调,需要客户侧具备接受http post请求和解析的能力。
视频监控(qvs)回调的http post示例如下

curl -X POST \
--url http://11.11.11.11:8888/callback \
-H "Content-Type:application/json" \
--data '{"type": "stream", "nsId": "xxx","streamId": "xxx", "streamState": xxx, "timeSec": xxx, "reqId": "xxx"}'

其中url"11.11.11.11:8888/callback"就是客户在空间中已配置好的回调地址

最近更新时间: 2020-12-09 11:29:12

1.如何触发流状态回调？空间中需要配置回调地址，这是前提条件。具体操作如下

通过api创建或者更新空间的客户，可以填充callBack字段，该字段就是回调地址，例如该字段形式为 www.qiniu.com/callback 或者 11.11.11.11:8888/callback
用户也可以通过视频监控(qvs)的官方控制台，在portal中，添加回调地址(后续的portal版本会添加对流状态回调的支持)

2.触发回调的时机和格式？

在流连接和断开时，会分别触发回调
回调的格式，采用http post请求。body采用json编码，并固定以下几个字段，根据实际情况会调整，并保持兼容。

{
  "type": "stream"          // 回调类型
	"nsId": "xx",            // 空间id, (字符串类型)
	"streamId": "xx",        // 流id， (字符串类型)
	"streamState": 1,        // 0:流断开 1:流连接, (整型)
	"timeSec": xx,   // streamState为0,代表流断开的时间戳；streamState为1,代表流连接的时间戳，(整型)
	"reqId": "xx" //唯一标示，(字符串类型)
}

视频监控(qvs)回调,需要客户侧具备接受http post请求和解析的能力。
视频监控(qvs)回调的http post示例如下

curl -X POST \
--url http://11.11.11.11:8888/callback \
-H "Content-Type:application/json" \
--data '{"type": "stream", "nsId": "xxx","streamId": "xxx", "streamState": xxx, "timeSec": xxx, "reqId": "xxx"}'

其中url"11.11.11.11:8888/callback"就是客户在空间中已配置好的回调地址