巡检抓拍 API 使用说明

概念

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

基本流程

1. 集成应用：订阅巡检抓拍任务事件巡检抓拍任务事 vid-inpsect-evt（可选同时订阅 伊爱聚合事件 eeye-stm-inspect-evt）
2. 集成应用：根据一定的条件（如终端上线后）调用创建巡检抓拍任务接口（可带 priority / guid / ai）
3. 媒体服务：收到巡检抓拍任务后，登记任务，返回任务信息（含任务ID），并通过消息队列通知巡检抓拍服务
4. 巡检抓拍服务：收到巡检抓拍任务消息，按优先级排队并执行（同终端多通道一体串行；不抢占已执行任务）
5. 巡检抓拍服务：任务执行过程中，或到最后的成功或失败，向巡检抓拍任务事件消息队列发出巡检抓拍任务事件通知；全通道结束后可双发聚合事件
6. 集成应用：接收巡检抓拍任务事件通知并作相应业务处理

接口列表

接口	用途
创建巡检抓拍任务	用于创建一个巡检抓拍任务。
查询巡检抓拍任务信息	用于查询某一个或某个时间段某个终端的巡检抓拍任务。
获取巡检抓拍图片	用于获取某一个巡检抓拍任务的特定通道的抓拍图片或缩略图文件。
巡检服务观察 API	vid-inspect 进程：就绪 /v1/info、内存队列 /v1/queue（独立端口，只读）。

WebSocket 对等（StrmWsApi，since strm-js 1.1.3）：vidInspect/create、vidInspect/qry（取图仍走 HTTP）。见 巡检抓拍相关方法。

注意事项

巡检服务设置了最大并发任务数与等待队列上限（maxQueuedTasks，默认 200）。当当前执行中任务数已达并发上限时，新任务进入优先级等待队列；等待队列超限时，创建任务请求返回 -23。集成应用应限制并发请求数，并对 -23 适当休眠后重试。