最近更新时间：2023.07.06 15:25:38
首次发布时间：2023.01.09 17:19:04
获取设备预置位信息。
使用 POST 方式发起请求。
下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。
字段 | 位置 | 类型 | 必填 | 说明 | 值 |
|---|---|---|---|---|---|
| Action | Query | String | 是 | 公共参数，OpenAPI 接口名称 | QueryPresetInfo |
| Version | Query | String | 是 | 公共参数，OpenAPI 接口版本 | 2021-01-01 |
| SipID | Query | String | 否 | SIP 服务器 ID |
字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| DeviceID | String | 是 | 设备国标 ID，可通过调用 ListDevices 接口获取 |
| ChannelID | String | 是 | 通道 ID，可通过调用 ListStreams 接口获取 |
| TimeOut | Int | 否 | 查询超时时间，单位：秒（默认值5秒） |
通用返回参数，请参考 ResponseMetadata 结构体说明。
Result 字段包含以下参数：
字段 | 类型 | 说明 |
|---|---|---|
| Num | Integer | 查询到的记录数量 |
| Item | Array of objects | 查询到的预置位信息列表，参考以下 预置位信息结构说明 |
预置位信息结构说明
字段 | 类型 | 说明 |
|---|---|---|
| PresetID | Integer | 预置位 ID |
| PresetName | String | 预置位名称（预置位1，预置位2，...） |
POST https://open.volcengineapi.com?Action=QueryPresetInfo &Version=2021-01-01 &SipID=340200000020xxxxxxxx &<公共请求参数> { "DeviceID":"340200859911xxxxxxxx", "ChannelID":"110000005813xxxxxxxx", "timeout": 30 }
{ "ResponseMetadata": { "RequestId": "2022020809562401020404907915037F68", "Action": "QueryPresetInfo", "Version": "2021-01-01", "Service": "aiotvideo", "Region": "cn-north-1" }, "Result": { "Num": 1, "Item": [ { "PresetID": 1, "PresetName": "预置位1" ] }