设置设备图片参数
接口描述
根据设备序列号设置设备的图片参数,包括分辨率和画质。
注意:当前仅支持场内设备的图片参数设置。
请求说明
| 接口ID | 协议 | 方法 | PATH |
|---|---|---|---|
| 68 | HTTPS | POST | /openapi/v1/stp/user/devices/:sn/image_param |
PATH参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sn | string | 是 | PATH中的:sn需要替换为具体的设备序列号 |
URL参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accesskey_id | string | 是 | 参见签名认证 |
| expires | int | 是 | 参见签名认证 |
| signature | string | 是 | 参见签名认证 |
HTTP请求头
| 字段 | 值 |
|---|---|
| Content-Type | application/json |
请求参数
请求参数以Json格式放置于Body中,如下:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| resolution | string | 是 | 分辨率值,必须是设备支持的分辨率之一 |
| quality | int | 是 | 画质值,取值范围为 10-100,步长为 10 |
注:resolution 和 quality 的可选值需要先调用"获取设备图片参数"接口获取。
请求示例
POST https://open.vzicloud.com/openapi/v1/stp/user/devices/12345678-87654321/image_param?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 52
Content-Type: application/json
{
"resolution": "1920*1080",
"quality": 80
}
返回说明
设置成功返回空响应。