调整取流清晰度

接口描述

调整设备的视频流清晰度,云端会主动修改设备的码流配置,并调整带宽占用和限速。

注意,当调整一台设备的清晰度时,该设备的所有子码流的取流连接清晰度都会改变(不论是局域网取流还是远程取流,)。

调整可能会因为以下原因导致失败:

  • 设备无法通信或响应超时
  • 设备流调整协议暂不兼容
  • 调整后带宽占用超过总带宽

使用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
}

results matching ""

    No results matching ""