功能详情

对GB28181摄像头的预置位进行控制操作，支持新增、到达（跳转）和删除预置位。

注意：该接口仅支持GB28181协议对接的摄像头。

请求地址和方法

• 请求地址

https://www.sdzhiot.top/api/v3/camera/preset/control

• 请求方法

POST

参数说明

• 请求头

Content-Type:application/json;charset=UTF-8

• 请求参数

字段名	字段类型	字段说明	是否必须
serial	String	设备序列号（国标ID）	Y
channel	String	通道号（多通道设备需指定具体通道号）	N
cmd	String	控制指令（详见下文：预置位控制指令）	Y
name	String	预置位名称（cmd为set时有效）	N
presetId	Integer	预置位ID（cmd为goto或remove时必须）	N

预置位控制指令

指令	描述	必填参数
set	新增预置位，将当前位置保存为预置位	name（预置位名称）
goto	到达预置位，云台转动到指定预置位	presetId（预置位ID）
remove	删除预置位	presetId（预置位ID）

样例输入

• 新增预置位

{
    "serial": "34020000001320000001",
    "channel": "34020000001320000002",
    "cmd": "set",
    "name": "监测点位A"
}

• 到达预置位

{
    "serial": "34020000001320000001",
    "channel": "34020000001320000002",
    "cmd": "goto",
    "presetId": 1
}

• 删除预置位

{
    "serial": "34020000001320000001",
    "channel": "34020000001320000002",
    "cmd": "remove",
    "presetId": 1
}

返回data字段说明

字段名	字段类型	字段说明
id	Integer	预置位ID
name	String	预置位名称
token	String	预置位token（ONVIF设备返回，国标设备为空字符串）

样例输出

{
    "code": 0,
    "data": {
        "id": 3,
        "name": "监测点位A",
        "token": ""
    },
    "msg": "操作成功"
}

返回码

返回码	返回消息	说明
0	操作成功	请求成功
500	服务器错误	服务端异常
10001	参数为空或格式不正确	参数错误
10002	appKey不存在	确认appKey是否正确
10004	签名错误	参数签名错误