Events API
Events API 用于读取与目标跟踪相关的事件数据。事件记录可包含摄像头、标签、区域、时间、缩略图/快照和子标签等信息。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
筛选
按时间、摄像头、标签或区域筛选，避免一次请求过大的历史范围。
事件生命周期
跟踪对象在开始、更新、结束阶段的数据可能变化，最终结果以结束后的记录为准。
媒体
事件存在并不保证快照/录像仍在保留期内。
实时更新
需要实时变化时优先使用 MQTT/WebSocket，而不是高频轮询历史 API。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Events API
Events APIs expose tracked-object event data such as camera, label, zones, times, media and sub-label metadata.
Core behavior
This page is topic-specific rather than a generic placeholder.
Filtering
Filter by time, camera, label or zone instead of requesting huge ranges.
Lifecycle
Tracked-object metadata can evolve until the event ends.
Media retention
Event metadata may outlive associated media.
Realtime
Use MQTT/WebSocket for live updates instead of aggressive polling.
Verification and troubleshooting
- Record the current version/config before changes so rollback is possible.
- Verify both UI state and backend logs after the change.
- If only one camera/plugin is affected, isolate it before making global changes.
Events API
La API de eventos expone datos de objetos: cámara, etiqueta, zonas, tiempo, medios y subetiquetas.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Filtros
Filtre por tiempo, cámara, etiqueta o zona.
Ciclo
Los metadatos pueden cambiar hasta finalizar el evento.
Retención
Los metadatos pueden durar más que los medios.
Tiempo real
Use MQTT/WebSocket en vez de sondeo frecuente.
Verificación y diagnóstico
- Registre versión/configuración antes de cambiar para poder revertir.
- Compruebe UI y logs del backend después.
- Si afecta a una sola cámara/plugin, aíslelo antes de cambios globales.