园区智能体 CampusGo-创建云上关键岗位检测作业:请求
下载园区智能体 CampusGo用户手册完整版
请求
- 请求样例（VIS输入+DIS输出）
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-staffonduty-cloud/tasks{ "name":"staffonduty_cloud_0", "description":"staffonduty task test", "input":{ "type":"vis", "data":[ { "stream_name":"staffonduty", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-staffonduty" } }, "service_version":"3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "service_config":{ "common":{ "target_roi":"{\"polygons\":[{\"data\":[[484,465],[1850,450],[1905,1013],[515,1050]]},{\"data\":[[484,125],[1800,125],[1800,677],[495,677]]}]}", "image_compression_ratio":90, "key_region_detection_sw":1, "key_region_detect_interval":2, "key_region_detect_threshold":2, "key_region_person_count":50 } }}
- 参数说明
参数
是否必选
类型
说明
name
是
String
作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。
description
否
String
作业描述信息，最大长度为500字符长度。
input
是
Object
视频数据输入列表，目前云上关键岗位检测支持以下输入类型：- vis：从 视频接入服务 中读取视频数据。
详细参数定义参见task.input（任务输入参数）。
service_version
是
String
功能版本号，版本号为3.0。
resource_order_id
是
String
购买的算法能力包ID，在服务界面购买算法能力包获取。
output
service_config
是
否
Object
Object
结果数据的输出列表，目前支持将结果输出到您指定的通道中，输出类型为“dis”。
详细参数定义参见task.output（任务输出参数）。
服务的算法配置，配置参数见ServiceConfig参数说明。
- service_config参数结构说明
参数
是否必选
类型
说明
key_region_detection_sw
否
Int
对应控制台的界面参数“关键岗位检测开关”。
是否开启关键岗位检测告警，取值范围：- 0：表示不开启
- 1：表示开启
默认值为1。
key_region_person_count
否
Int
对应控制台的界面参数“在岗最小人数”。
关键岗位检测区域的最少人数，取值范围为[1, 100]，默认值为2。该参数只对同级列表中的输入生效。
key_region_detect_interval
否
Int
对应控制台的界面参数“检测周期”。
关键区域检测周期，单位为秒。取值范围为[1, 3600]，默认值为1。当时间到达检测周期整数倍时，触发算法检测在岗人数。
key_region_detect_threshold
否
Int
对应控制台的界面参数“告警触发阈值”。
告警触发阈值，单位为检测周期个数。取值范围为[1, 3600]，默认值为60。假设告警触发阈值为N，当连续N个检测周期时间内检测结果都不满足最小在岗人数，则触发告警。触发告警或满足在岗人数则重新开始计数，直到再次达到告警阈值。
image_compression_ratio
否
Int
对应控制台的界面参数“图片压缩比”。
取值范围[20，100]，默认值：90，表示图片压缩比90%。
target_roi
否
String
对应控制台的界面参数“检测区域设置”。
表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。
例如：
{"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]}
参数没有携带时，默认区域为整个视频帧中间的1/4。
- 当区域的坐标值全为0时，区域默认位置如图1 区域默认位置所示，其中Wframe为帧宽度，Hframe为帧高度。
图1 区域默认位置
- 默认区域为矩形，假设矩形的四个端点分别为point_1、point_2、point_3、point_4，其位置默认为：
- poin_1=(¼Wframe， ¼Hframe)
- poin_2=(¾Wframe， ¼Hframe)
- poin_3=(¼Wframe， ¾Hframe)
- poin_4=(¾Wframe， ¾Hframe)
- 默认区域为矩形，假设矩形的四个端点分别为point_1、point_2、point_3、point_4，其位置默认为：
