视频接入分析服务 VIAS-创建边缘关键岗位检测作业:请求
请求
- 请求样例1(VCN输入+WEBHOOK输出)
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-staffonduty-edge/tasks { "name": "staffonduty-task", "description": "staffonduty task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "stream_type": 1, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6" } ] }, "output": { "webhook":{ "url":"https://apigw.xx.com/api/mqs/sit", "headers":{ "content-type":"application/json" } } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "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 } } }
- 请求样例2(摄像头输入+DIS输出)
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-staffonduty-edge/tasks { "name": "staffonduty-edge-task", "description": "staffonduty task test", "input": { "type": "edgecamera", "data": [ { "id": "aec5857c-222f-4aa9-be39-23654e118886", "index": 0 } ] }, "output": { "dis": { "stream_name": "dis-staffonduty-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "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 } } }
- 请求样例3(edgerestful输入+DIS输出)
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-staffonduty-edge/tasks { "name": "staffonduty-task", "description": "staffonduty task test", "input": { "type": "edgerestful", "data": [ { "index": 0, "url":"https://100.127.134.69:554/test/data", "certificate_check": false, "rtsp_path_in_response": "data/url" } ] }, "output": { "dis": { "stream_name": "dis-staffonduty-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "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 } } }
- 请求样例4(VCN输入+DIS输出)
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-staffonduty-edge/tasks { "name": "staffonduty-task", "description": "staffonduty task test", "input": { "type": "vcn", "vcn":{ "ip":"172.100.119.6", "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=", "port":"4675", "username":"testname" }, "data": [ { "index": 0, "stream_type": 1, "device_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6" } ] }, "output": { "dis": { "stream_name": "dis-staffonduty-edge" } }, "service_version": "3.0", "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e", "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a", "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
视频数据输入列表,支持从指定的边缘摄像头读取数据,即输入类型为“edgecamera”,“edgerestful”,“VCN”。
详细参数定义参见task.input(任务输入参数)。
service_version
是
String
功能版本号,版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。
resource_order_id
是
String
购买的算法能力包ID,在服务界面购买算法能力包获取。
edge_pool_id
是
String
边缘运行池ID,获取方法参见创建边缘运行池。
output
是
Object
结果数据的输出列表,目前支持以下输出类型:- DIS:将结果输出到您指定的DIS通道 。
- Webhook:将结果输出到Webhook URL。
- Localpath:将作业的运行结果保存在边缘节点本地(节点必须为linux系统),必须为linux路径,例如“/opt/cloud/”。
详细参数定义见task.output(任务输出参数)。
service_config
否
Object
服务的算法配置,配置参数见service_config参数说明。
- service_config参数说明
参数
是否必选
类型
说明
common
否
Object
作业参数配置,配置参数见common参数说明。
- common参数说明
参数
是否必选
类型
说明
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。
- 当target_roi参数未设置时,区域默认位置如图1所示,其中Wframe为帧宽度,Hframe为帧高度。
- 默认区域为矩形,假设矩形的四个端点分别为point_1、point_2、point_3、point_4,其位置默认为:
- point_1=(¼Wframe, ¼Hframe)
- point_2=(¾Wframe, ¼Hframe)
- point_3=(¼Wframe, ¾Hframe)
- point_4=(¾Wframe, ¾Hframe)
- 默认区域为矩形,假设矩形的四个端点分别为point_1、point_2、point_3、point_4,其位置默认为: