创建云上个体事件行为检测作业
功能介绍
该API可分析视频流。当用户设置的区域中有人吸烟、打手机动作,则上报告警。
![](https://support.huaweicloud.com/api-campusgo/public_sys-resources/note_3.0-zh-cn.png)
- 视频编码格式支持H264或者H265。
调试
您可以在API Explorer中调试该接口。
URI
- URI格式
POST /v2/{project_id}/services/c-event-action-recog-cloud/tasks
- 参数说明
参数
是否必选
类型
说明
project_id
是
String
服务所在区域对应的项目ID,获取方法请参见获取项目ID。
请求
- 请求样例(VIS输入+DIS输出)
POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-event-action-recog-cloud/tasks { "name":"event-action-recog-cloud-task", "description":"event-action-recog task test", "input":{ "type":"vis", "data":[ { "stream_name":"event-action-recog-cloud-video", "index":0 } ] }, "output":{ "dis":{ "stream_name":"dis-event-action-recog-cloud" } }, "service_version":"3.0", "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e", "service_config":{ "common":{ "smoking_detection_sw":1, "phoning_detection_sw":0, "render_result_sw":1, "render_roi_sw":1, "target_roi":"{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}", "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参数说明
字段
是否必选
类型
说明
smoking_detection_sw
否
Int
对应控制台的界面参数“吸烟检测开关”。
对输入视频流是否检测吸烟动作,取值范围:
- "0":表示不检测吸烟动作;
- "1":表示检测吸烟动作。
默认值为1。
phoning_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(目标区域)。
例如:
{"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]}
参数没有携带时,默认区域为整个视频帧。
image_compression_ratio
否
Int
对应控制台的界面参数“图片压缩比”。
图片压缩百分比,取值范围为[20,100]。
默认值:90,表示图片压缩比为90%。
响应
- 响应样例
[ { "id": "5a127c7844674d2382b7daae07794152" } ]
- 返回作业ID列表
参数
类型
说明
id
String
作业ID。
检测结果
- 输出JSON数据流到DIS指定的通道,包括告警结构化数据和图片数据。
- JSON结果示例:
{ "stream_id": "vis-event-action-recog-cloud", "event_type":720896, "task_id":"5a127c7844674d2382b7daae07794152", "timestamp": 1527603463, "message_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218", "image_base64": "/3j24AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE...", "data":{ "event_set":[ { "bounding_box":{ "x":100, "y":200, "w":80, "h":150 } }, { "bounding_box":{ "x":200, "y":300, "w":70, "h":150 } } ] } }
- JSON格式说明
字段
类型
说明
stream_id
String
该字段为VIS视频流名称。
event_type
Int
快速标识输出消息类型
- 吸烟动作检测算法其值固定为720896;
- 打手机动作检测算法其值固定为786432;
task_id
String
作业ID。
timestamp
Uint64
触发告警时间点的时间戳。
message_id
String
告警ID,生成的唯一告警事件UUID。
image_base64
String
告警时刻输入的视频图像的Base64编码结果。
data
Object
输出结果列表,每组数据对应触发告警的告警ID和目标列表,具体参见data参数说明。
- data参数格式说明
字段
类型
说明
event_set
List<Object>
输出事件列表。
- event_set参数格式说明
字段
类型
说明
bounding_box
Object
输出告警对象矩形框。
- bounding_box参数格式说明
字段
类型
说明
x
Int
矩形框左上角横坐标。
y
Int
矩形框左上角纵坐标。
w
Int
矩形框宽度。
h
Int
矩形框高度。
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误,具体返回错误码请参考错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误
503 Service Unavailable
服务不可用。