调整取流清晰度
接口描述
调整设备的视频流清晰度,云端会主动修改设备的码流配置,并调整带宽占用和限速。
注意,当调整一台设备的清晰度时,该设备的所有子码流的取流连接清晰度都会改变(不论是局域网取流还是远程取流,)。
调整可能会因为以下原因导致失败:
- 设备无法通信或响应超时
- 设备流调整协议暂不兼容
- 调整后带宽占用超过总带宽
使用mjpeg上云的设备无法调整清晰度,即便配置成功,远程取流的效果也不会改变
请求说明
接口ID | 协议 | 方法 | PATH |
---|---|---|---|
12 | HTTPS | PUT | /openapi/v1/stp/user/devices/vurl |
PATH参数
无
URL参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
accesskey_id | string | 是 | 参见签名认证 |
expires | int | 是 | 参见签名认证 |
signature | string | 是 | 参见签名认证 |
HTTP请求头
字段 | 值 |
---|---|
Content-Type | application/json |
请求参数
请求参数以Json格式放置于Body中,如下:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
sn | string | 是 | 设备的SN |
config_id | int | 是 | 清晰度代码 |
config_id 的定义如下:
config_id | 清晰度 | 码率 |
---|---|---|
1 | 标清 | 256Kbps |
2 | 高清 | 512Kbps |
请求示例
PUT https://open.vzicloud.com/openapi/v1/stp/user/devices/vurl?accesskey_id=8dlP5tsD2115Q2ec9fCkX2wHSIIlhCO8&expires=1638240891&signature=WH4sif5GAjaiivX0moBP7FcP8Kg%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 44
Content-Type: application/json
{"sn": "12345678-87654321", "config_id": 1}
注意:您无法将请求示例的链接地址贴入浏览器直接运行,此示例仅展示URL格式,由于AccessKey具备有效期,您访问时此链接已过期。
返回说明
参数 | 类型 | 说明 |
---|---|---|
count | int | 请求影响到的取流连接数量 |
注意:count 为 0 时,表示当前设备没有取流,但是设备的编码参数还是会发生变化。
返回示例
{
"count": 1
}