设置AI识别任务的运行时间段
更新时间：2023-12-13
接口描述
为视频流绑定的AI识别任务，设置运行时间段，确保AI识别任务只在匹配的时间段运行，非运行时间段的AI识别任务会暂停。如果一个视频流上的所有AI识别任务都暂停，则对应的合成流也会暂停,当符合运行时间段时，AI识别任务和对应合成流（如果已经暂停）也会恢复运行。
请求结构
PUT /console/api/v1/device/set_cycle_detect_job
请求头域
| 请求头名称 | 描述 | 示例 |
|---|---|---|
| Authorization | 认证头。登录响应返回的token内容，如果不填或者填错会拒绝请求 | Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImFkbWluIiwiZXhwIjoxNjY3NDc4OTc4fQ.JL9R7CqIhPFdQWZry4e9ONZntUTmNzBp0sDE05rMxl |
请求参数
| 参数 | 类型 | 是否必选 | 描述 | 示例 |
|---|---|---|---|---|
| deviceId | Array of Int64 | 是 | 批量操作的设备ID列表 | [3, 7] |
| aiRunTime | Json | 是 | AI识别任务的运行时间段配置 | {"aiRunTime": { "aiCycleRunTime": {"face": [ {"month": [1,2,12], "weekday": [0, 1, 6], "day": [1,2,31], "hour": [8,9,10,11,14,15,16,17,18], "hourMinuteRange": [30,31,...59] } ] } } } |
| +aiCycleTime | Json | 是 | 不同AI的运行时间段配置。key是AI算法英文唯一名称，value是一组时间段配置。如果key不包含某个算法，则表示该算法对应的识别任务一直运行。value数组中只要有一项匹配某个时间段（不必数组中每一项都匹配），那么在对应时间段上该AI识别任务就会运行。 | |
| ++month | Array of Int32 | 否 | 匹配运行的月份，可选值为1~12。如果为空或不设置，则表示不匹配任何月份 | [1,2, 12] |
| ++day | Array of Int32 | 否 | 匹配运行日期的数组，可选值为1~31。如果为空或不设置，则表示不匹配任何日期。 | [3, 9, 31] |
| ++weekday | Array of Int32 | 否 | 匹配运行星期的数组，可选值为0~6。0表示星期日。如果为空或不设置，则表示不匹配任何星期。 | [0, 1, 5, 6] |
| ++hour | Array of Int32 | 否 | 匹配运行小时的数组，可选值为0~23。如果为空或不设置，则表示不匹配任何小时。 | [0, 1, 13, 23 ] |
| ++hourMinuteRange | Json | 否 | 指定起始分钟的运行时间段配置。如果未设置（为空属于已设置)则忽略该字段。如果该字段已设置，则忽略hour字段。 | 9:30 ~ 18:30 |
| +++startHour | Int32 | 否 | 开始运行的小时。默认为0 | 23 |
| +++startMinute | Int32 | 否 | 开始运行的分钟。默认为0 | 59 |
| +++endHour | Int32 | 否 | 结束运行的小时。 默认为0 | 14 |
| +++endMinute | Int32 | 否 | 结束运行的分钟。默认为0 | 29 |
响应头域
无特殊响应头。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| status | int32 | 接口返回状态, 0表示成功，其他表示失败 |
| message | 字符串 | 成功或错误提示 |
| data | JSON | 占位符，目前固定为null |
请求示例
POST /console/api/v1/device/add HTTP/1.1
Content-Type: application/json
Content-Length: 1254
Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImFkbWluIiwiZXhwIjoxNjY4NjgxODg5fQ.NkjiNOeMnzP9To-CuV4F9306OH1RY0xz69RG4dstTSk
{
"deviceId": [1, 3],
"aiRunTime": {
"aiCycleRunTime": {
"face": [
{
"month": [1,2,...,12],
"weekday": [0, 6],
"day": [1,2,3,...,31],
"hour": [8, 9,10,11]
},
{
"month": [1,2],
"weekday": [1,2,...,5],
"day": [1,2,3,...,31],
"hourMinuteRange": {
"startHour": 8,
"startMinute": 30,
"endHour": 18,
"endMinute": 30
}
}
],
"fire": [
{
"month": [1,2,...,12],
"weekday": [0,1,..., 6],
"day": [28，29， 30， 31],
"hour": [8,9,...,17]
}
]
}
}
}如上示例，配置了设备1和3的AI任务运行时间段。表示人脸算法运行时间段为：1~12月每个周末的8:00~11:59分 和 1,2月每个工作日的8:30~18:30；火焰识别算法运行时间段为: 每个月的28~31号的8:00~17:59分。该设备的其他算法为全时间段运行。
响应示例
{
"status": 0,
"message": "success",
"data"：null
}