Cameras API
摄像头 API 用于查询摄像头列表、状态、图像/媒体入口及相关控制能力。调用前先检查摄像头是否在线以及对应功能是否启用。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
名称
API 中摄像头标识通常对应配置文件中的 camera key；不要把 friendly name 当作稳定 ID。
媒体
快照、实时流和录像是不同媒体路径；某一路失败不代表摄像头完全离线。
能力
PTZ、对讲、LPR 等功能应通过服务器/插件能力判断是否可用。
缓存
实时状态不应被长时间缓存。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Cameras API
Camera APIs expose camera inventory, status, media/image access and capabilities. Check online state and feature support first.
Core behavior
This page is topic-specific rather than a generic placeholder.
Names
Use the configured camera key as the stable identifier.
Media
Snapshot, live and recording paths are distinct.
Capabilities
PTZ, talk and enrichments should be gated by capability checks.
Caching
Do not heavily cache live camera status.
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.
Cameras API
La API de cámaras expone inventario, estado, medios e interfaces de control. Compruebe estado y capacidades.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Nombres
Use la clave de configuración como ID estable.
Medios
Snapshot, live y grabación son rutas distintas.
Capacidades
PTZ, talk y enriquecimientos deben comprobar soporte.
Caché
No cachee estado en vivo por mucho tiempo.
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.