录像 API
录像 API 用于查询指定摄像头和时间范围内的录像片段或播放信息。返回结果依赖 record 是否启用以及媒体是否仍在保留期。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
时间范围
客户端应使用明确的开始/结束时间并处理时区；跨日查询不要假定本地日期等于服务器 UTC。
连续性
摄像头掉线或 FFmpeg 重启会产生录像空洞，API 不应伪造连续片段。
保留
超出保留期后，事件元数据可能还在，但录像文件已经清理。
下载
大文件下载应支持超时、断线和进度提示。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Recordings API
Recording APIs query recorded media for a camera/time range. Results depend on recording being enabled and retained.
Core behavior
This page is topic-specific rather than a generic placeholder.
Time range
Use explicit timestamps and handle time zones correctly.
Continuity
Camera/FFmpeg interruptions can create recording gaps.
Retention
Media may be deleted even when metadata remains.
Downloads
Handle long transfers, timeouts and progress.
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.
API de grabaciones
La API de grabaciones consulta medios por cámara/tiempo y depende de que la grabación esté habilitada y retenida.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Tiempo
Use timestamps explícitos y gestione zonas horarias.
Continuidad
Caídas de cámara/FFmpeg crean huecos.
Retención
Los medios pueden borrarse aunque queden metadatos.
Descargas
Gestione transferencias largas, timeout y progreso.
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.