视频接入分析服务 VIAS-创建边缘关键岗位检测作业:请求

时间:2023-12-26 14:16:15

请求

  • 请求样例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为帧高度。
    图1 区域默认位置
    • 默认区域为矩形,假设矩形的四个端点分别为point_1、point_2、point_3、point_4,其位置默认为:
      • point_1=(¼Wframe, ¼Hframe)
      • point_2=(¾Wframe, ¼Hframe)
      • point_3=(¼Wframe, ¾Hframe)
      • point_4=(¾Wframe, ¾Hframe)
support.huaweicloud.com/api-vias/vias_03_0028.html