巡检抓拍 API 使用说明
概念
巡检抓拍由集成应用发起,由巡检抓拍服务调用媒体服务API,打开指定终端的实时视频,从视频码流中解码出一张图片并保存供后续应用使用。
基本流程
- 集成应用:根据一定的条件(如终端上线后)调用创建巡检抓拍任务
- 媒体服务:收到巡检抓拍任务后,登记任务,返回任务信息(含任务ID),并通过消息队列通知巡检抓拍服务
- 巡检抓拍服务:收到巡检抓拍任务消息,创建任务并执行
- 巡检抓拍服务:任务执行过程中,或到最后的成功或失败,向消息队列(
vid-inpsect-evt
)发出巡检抓拍任务事件通知 - 集成应用:接收巡检抓拍任务事件通知并作相应业务处理
注意事项
巡检服务设置了最大并发任务数,当当前执行中任务数已经达到这个阈值时,新的创建任务请求会返回 -23
错误码。集成应用也应相应限制的并发请求数,并对创建任务返回的错误码进行适当处理,
如返回 -23
时适当休眠一段时间再重试。