开发者平台

 TP-LINK官网首页
VMS平台
V2.0.19
开发者平台 / 视频管理系统（VMS）/API功能接口定义/设备消息透传

4.14.3 区域入侵参数配置

区域入侵会和多种报警配置合并，例如电瓶车检测功能。电瓶车检测功能的开启是基于区域入侵的功能开启，相当于在区域入侵的功能上叠加电瓶车检测。



4.14.3.1 区域入侵开关配置

              {
                  "method": "set",
                  "intrusion_detection": {
                      "detection": {
                          "enabled": "on"
                      }
                  }
              }
              
              Response:
              {
                  "error_code": 0
              }

请求参数说明：

参数 类型 说明
enabled 字符串 选择禁用/启用区域入侵功能。
取值范围：
on：启用
off：禁用

4.14.3.2 获取区域入侵开关配置

              Request:
              {
                  "method": "get",
                  "intrusion_detection": {
                      "name": "detection"
                  }
              }
              
              Response:
              {
                  "error_code": 0,
                  "intrusion_detection": {
                      "detection": {
                          "enabled": "on"
                      }
                  }
              }

返回参数说明：

参数 类型 说明
enabled 字符串 区域入侵功能开启状态。
取值范围：
on：启用
off：禁用

4.14.3.3 配置区域入侵

              {
                "method":"do",
                "intrusion_detection":
                {
                  "add_regions":
                  {
                      "region_info":
                      [
                        {
                          "id": "1",
                          "pt1_x":3000,
                          "pt1_y":3500,
                          "pt2_x":2000,
                          "pt2_y":5500,
                          "pt3_x":3500,
                          "pt3_y":8000,
                          "pt4_x":4875,
                          "pt4_y":4000,
                          "position_pan": "0.200000",
                          "position_tilt": "-0.700000",
                          "position_zoom": "0.100000",
                          "threshold":"0",
                          "percentage":"51",
                          "sensitivity":"50",
                          "people_enabled": "off",
                          "vehicle_enabled": "off",
                          "ebike_enabled": "on",
                          "constant_alarm_enabled": "on",
                          "non_vehicle_enabled": "off"
                        },
                        {
                          "id": "2",
                          "pt1_x":300,
                          "pt1_y":350,
                          "pt2_x":200,
                          "pt2_y":550,
                          "pt3_x":350,
                          "pt3_y":800,
                          "pt4_x":485,
                          "pt4_y":400,
                          "position_pan": "0.200000",
                          "position_tilt": "-0.700000",
                          "position_zoom": "0.100000",
                          "threshold":"0",
                          "percentage":"51",
                          "sensitivity":"50",
                          "people_enabled": "off",
                          "vehicle_enabled": "off",
                          "ebike_enabled": "on",
                          "constant_alarm_enabled": "on",
                          "non_vehicle_enabled": "off"
                        }
                      ]
                  }
                }
              }
             
              Response:
              {
                  "error_code": 0
              }

请求参数说明：

参数 类型 说明
id 字符串 区域入侵区域编号，表示配置的坐标信息为第几个区域入侵坐标。总共可配置4个区域。
pt1_x 整型 区域入侵矩形，左上角点位的x坐标
pt1_y 整型 区域入侵矩形，左上角点位的y坐标
pt2_x 整型 区域入侵矩形，右上角点位的x坐标
pt2_y 整型 区域入侵矩形，右上角点位的y坐标
pt3_x 整型 区域入侵矩形，右下角点位的x坐标
pt3_y 整型 区域入侵矩形，右下角点位的y坐标
pt4_x 整型 区域入侵矩形，左下角点位的x坐标
pt4_y 整型 区域入侵矩形，左下角点位的y坐标
position_pan 其他 设备当前的水平位置信息，当module_spec字段中包含"ptz"或"motor"字段时有该字段。
position_tilt 其他 设备当前的垂直位置信息，当module_spec字段中包含"ptz"或"motor"字段时有该字段。
position_zoom 其他 设备当前的缩放倍数信息，当module_spec字段中包含"ptz"字段并且ptz Capability 包含“position_zoom_range”字段时有该字段。
thresholf 整型 时间阈值
percentage 其它 占比
取值范围：1-100
sensitivity 其它 灵敏度
取值范围：1-100
people_enabled 字符串 人形识别开关
取值范围：
on：启用
off：禁用
vehicle_enabled 字符串 车辆识别开关
取值范围：
on：启用
off：禁用
ebike_enabled 字符串 电瓶车检测识别开关
取值范围：
on：启用
off：禁用
constant_alarm_enabled 字符串 持续报警开关
取值范围：
on：启用
off：禁用
仅当区域入侵侦测功能中有增强功能时使用。开启持续报警后，联动录像/白光报警/声音报警/报警接口输出保持持续触发；消息推送仅在事件第一次触发时生效，不做持续推送。
non_vehicle_enabled 字符串 非机动车识别开关
取值范围：
on：启用
off：禁用

4.14.3.4 获取区域入侵

              {
                  "intrusion_detection":
                  {
                      "table":["region_info"]
                  },
                  "method":"get"
              }
              
              Response:
              {
                  "error_code": 0,
                  "intrusion_detection":
                  {
                      "region_info":
                      [
                          {
                              "region_info_1":
                              {
                                  "id": "1",
                                  "pt1_x":3000,
                                  "pt1_y":3500,
                                  "pt2_x":2000,
                                  "pt2_y":5500,
                                  "pt3_x":3500,
                                  "pt3_y":8000,
                                  "pt4_x":4875,
                                  "pt4_y":4000,
                                  "position_pan": "0.200000",
                                  "position_tilt": "-0.700000",
                                  "position_zoom": "0.100000",
                                  "threshold":"0",
                                  "percentage":"51",
                                  "sensitivity":"50",
                                  "people_enabled": "off",
                                  "vehicle_enabled": "off",
                                  "channel" : "2",
                                  "ebike_enabled": "off",
                                  "constant_alarm_enabled": "off",
                                  "non_vehicle_enabled": "off"
                              }
                          }
                      ]
                  }
              }

获取参数说明：

参数 类型 说明
id 字符串 区域入侵区域编号，表示配置的坐标信息为第几个区域入侵坐标。总共可配置4个区域。
pt1_x 整型 区域入侵矩形，左上角点位的x坐标
pt1_y 整型 区域入侵矩形，左上角点位的y坐标
pt2_x 整型 区域入侵矩形，右上角点位的x坐标
pt2_y 整型 区域入侵矩形，右上角点位的y坐标
pt3_x 整型 区域入侵矩形，右下角点位的x坐标
pt3_y 整型 区域入侵矩形，右下角点位的y坐标
pt4_x 整型 区域入侵矩形，左下角点位的x坐标
pt4_y 整型 区域入侵矩形，左下角点位的y坐标
position_pan 其他 设备当前的水平位置信息，当module_spec字段中包含"ptz"或"motor"字段时有该字段。
position_tilt 其他 设备当前的垂直位置信息，当module_spec字段中包含"ptz"或"motor"字段时有该字段。
position_zoom 其他 设备当前的缩放倍数信息，当module_spec字段中包含"ptz"字段并且ptz Capability 包含“position_zoom_range”字段时有该字段。
thresholf 整型 时间阈值
percentage 其它 占比
取值范围：1-100
sensitivity 其它 灵敏度
取值范围：1-100
people_enabled 字符串 人形识别开关
取值范围：
on：启用
off：禁用
vehicle_enabled 字符串 车辆识别开关
取值范围：
on：启用
off：禁用
ebike_enabled 字符串 电瓶车检测识别开关
取值范围：
on：启用
off：禁用
constant_alarm_enabled 字符串 持续报警开关
取值范围：
on：启用
off：禁用
仅当区域入侵侦测功能中有增强功能时使用。开启持续报警后，联动录像/白光报警/声音报警/报警接口输出保持持续触发；消息推送仅在事件第一次触发时生效，不做持续推送。
non_vehicle_enabled 字符串 非机动车识别开关
取值范围：
on：启用
off：禁用

4.14.3.5 使用说明

如果需要使用区域入侵的增强功能，以电瓶车检测为例，则需要先开启区域入侵开关，再配置区域坐标信息，同时打开电瓶车检测开关和支持报警开关。