巡检抓拍 API 使用说明

概念

巡检抓拍由集成应用发起，由巡检抓拍服务调用媒体服务API，打开指定终端的实时视频，从视频码流中解码出一张图片并保存供后续应用使用。

基本流程

1. 集成应用：订阅巡检抓拍任务事件巡检抓拍任务事 vid-inpsect-evt
2. 集成应用：根据一定的条件（如终端上线后）调用创建巡检抓拍任务接口
3. 媒体服务：收到巡检抓拍任务后，登记任务，返回任务信息（含任务ID），并通过消息队列通知巡检抓拍服务
4. 巡检抓拍服务：收到巡检抓拍任务消息，创建任务并执行
5. 巡检抓拍服务：任务执行过程中，或到最后的成功或失败，向巡检抓拍任务事件消息队列发出巡检抓拍任务事件通知
6. 集成应用：接收巡检抓拍任务事件通知并作相应业务处理

接口列表

接口	用途
创建巡检抓拍任务	用于创建一个巡检抓拍任务。
查询巡检抓拍任务信息	用于查询某一个或某个时间段某个终端的巡检抓拍任务。
获取巡检抓拍图片	用于获取某一个巡检抓拍任务的特定通道的抓拍图片或缩略图文件。

注意事项

巡检服务设置了最大并发任务数，当当前执行中任务数已经达到这个阈值时，新的创建任务请求会返回 -23 错误码。集成应用也应相应限制的并发请求数，并对创建任务返回的错误码进行适当处理， 如返回 -23 时适当休眠一段时间再重试。