文档首页/ 园区智能体 CampusGo/ API参考/ 云上服务API/ 云上个体动作检测/ 创建云上个体动作检测作业
更新时间：2022-03-17 GMT+08:00
查看PDF
分享

创建云上个体动作检测作业

功能介绍

该API可分析视频流。当用户设置的区域中有人出现翻越、摔倒、挥手或者弯腰等动作，则上报事件。

  • 视频编码格式支持H264或者H265。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式 
    POST /v2/{project_id}/services/c-pose-action-recog-cloud/tasks
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    是

    String

    服务所在区域对应的项目ID，获取方法请参见获取项目ID。

请求

  • 请求样例（VIS输入+DIS输出） 
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-pose-action-recog-cloud/tasks
{
    "name":"pose-action-recog-cloud-task",
    "description":"pose-action-recog-cloud task test",
    "input":{
        "type":"vis",
        "data":[
            {
                "stream_name":"pose-action-recog-cloud-video",
                "index":0
            }
        ]
    },
    "output":{
        "dis":{
            "stream_name":"dis-pose-action-recog-cloud"
        }
    },
    "service_version":"3.0",
    "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e",
    "service_config":{
        "common":{
            "climb_detection_sw":1,
            "fall_detection_sw":0,
            "wave_detection_sw":0,
            "bend_detection_sw":0,
            "render_result_sw":1,
            "render_roi_sw":1,
            "target_roi":"{\"polygons\":[{\"data\":[[0,0],[0,1080],[1920,1080],[1920,0]]}]}",
            "image_compression_ratio":90
        }
    }
}
  • 参数说明

    参数

    是否必选

    类型

    说明

    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

    是

    Object

    结果数据的输出列表，目前支持将结果输出到您指定的通道中，输出类型为“dis”。

    详细参数定义参见task.output（任务输出参数）。

    service_config

    否

    Object

    服务的算法配置，配置参数见ServiceConfig参数说明。
  • service_config中common参数说明

    字段

    是否必选

    类型

    说明

    climb_detection_sw

    否

    Int

    对应控制台的界面参数“翻越检测开关”。

    对输入视频流是否检测翻越动作，取值范围：

    • "0"：表示不检测；
    • "1"：表示检测。

    默认值为1。

    fall_detection_sw

    否

    Int

    对应控制台的界面参数“摔倒检测开关”。

    对输入视频流是否检测摔倒动作，取值范围：

    • "0"：表示不检测；
    • "1"：表示检测。

    默认值为0。

    wave_detection_sw

    否

    Int

    对应控制台的界面参数“挥手检测开关”。

    对输入视频流是否检测挥手动作，取值范围：

    • "0"：表示不检测；
    • "1"：表示检测。

    默认值为0。

    bend_detection_sw

    否

    Int

    对应控制台的界面参数“弯腰检测开关”。

    对输入视频流是否检测弯腰动作，取值范围：

    • "0"：表示不检测；
    • "1"：表示检测。

    默认值为0。

    render_result_sw

    否

    Int

    对应控制台的界面参数“目标框渲染开关”。

    输出图像是否绘制告警目标边框，取值范围:

    • "0"：表示不绘制；
    • "1"：表示用红色绘制告警目标边框。

    默认值为0。

    render_roi_sw

    否

    Int

    对应控制台的界面参数“检测区域渲染开关”。

    输出图像是否绘制检测区域，取值范围:

    • "0"：表示不绘制；
    • "1"：表示用黄色绘制用户设定区域。

    默认值为0。

    target_roi

    否

    String

    对应控制台的界面参数“检测区域设置”。

    表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。

    例如：{"lines":[{"data":[[1,279],[908,44]]},{"data":[[50,460],[1180,74]]}],"polygons":[{"data":[[0,0],[0,720],[1280,720],[1280,0]]}]}

    参数没有携带时，默认区域为整个视频帧。

    image_compression_ratio

    否

    Int

    对应控制台的界面参数“图片压缩比”。

    取值范围[20，100]，默认值：90，表示图片压缩比90%。

响应

  • 响应样例 
    [
  { 
    "id": "5c127c7844674d2382b7daae07794152"
  }
]
  • 返回作业ID列表

    参数

    类型

    说明

    id

    String

    作业ID。

检测结果

  • 输出JSON数据流到指定的DIS通道，包括结构化数据。
  • JSON结果示例： 
    {
     "stream_id": "001",
     "event_type": 851968,
     "task_id":"5c127c7844674d2382b7daae07794152",
     "timestamp": 1527603463,
     "message_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
     "data":{
         "event_set":[
             {
                  "bounding_box":{
                       "x":100,
                       "y":200,
                       "w":80,
                       "h":150
                   }            
               },
              {
                   "bounding_box":{
                        "x":200,
                        "y":300,
                        "w":70,
                        "h":150
                   }                
               }
           ]   
      },
     "image_base64": "/3j24AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..."
}
  • JSON格式说明

    字段

    类型

    说明

    stream_id

    String

    该字段为VIS视频流名称。

    event_type

    Uint64

    快速标识个体动作检测输出告警的消息类型：

    • 翻爬动作检测算法其值固定为851968，对应16进制为 0x 0000 0000 000D 0000
    • 摔倒动作检测算法其值固定为851969，对应16进制为 0x 0000 0000 000D 0001
    • 挥手动作检测算法其值固定为851970，对应16进制为 0x 0000 0000 000D 0010
    • 弯腰动作检测算法其值固定为851971，对应16进制为 0x 0000 0000 000D 0011
    • 疑似采摘行为检测算法其值固定为852224，对应16进制为0x 0000 0000 000D 0100

    task_id

    String

    作业ID

    timestamp

    Uint64

    触发告警时间点的时间戳。

    message_id

    String

    告警ID，生成的唯一告警事件UUID

    data

    Object

    详细输出内容

    image_base64

    String

    告警时刻输入的视频图像的Base64编码结果。
  • data参数格式说明

    字段

    类型

    说明

    event_set

    List<Object>

    输出事件列表。
  • event_set参数格式说明

    字段

    类型

    说明

    bounding_box

    Object

    告警输出的个体动作检测对象矩形框。
  • bounding_box参数格式说明

    字段

    类型

    说明

    x

    Int

    矩形框左上角横坐标。

    y

    Int

    矩形框左上角纵坐标。

    w

    Int

    矩形框宽度。

    h

    Int

    矩形框高度。

返回值

  • 正常

    201

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误，具体返回错误码请参考错误码。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误

    503 Service Unavailable

    服务不可用。

相关文档