预览 API
预览 API 提供低成本时间线预览媒体，用于 Review/History 快速浏览。它不是完整录像文件，保留策略也可能不同。
核心说明
本页内容按该功能本身整理，不再使用通用占位说明。以下项目均与当前主题直接相关。
用途
用于快速拖动/预览，不应替代最终导出质量。
时间
客户端需要将预览片段与时间戳正确对齐。
缺失
摄像头中断或预览清理会造成区间缺失。
缓存
预览片段适合 CDN/浏览器缓存，但应按版本/时间键区分。
验证与排查
- 修改或执行前记录当前版本/配置，以便回退。
- 完成后同时检查 UI 状态和后端日志，不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现，先做最小范围对比，避免全局改动。
Preview API
Preview APIs provide lightweight timeline media for fast Review/History browsing and are distinct from full recordings.
Core behavior
This page is topic-specific rather than a generic placeholder.
Purpose
Use for fast browsing, not final export quality.
Timing
Align preview segments with timestamps accurately.
Gaps
Camera outages/retention can create preview gaps.
Caching
Preview segments are cacheable with safe version/time keys.
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 vista previa
La API preview proporciona medios ligeros para Review/History y es distinta de la grabación completa.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Uso
Sirve para navegar rápido, no para exportación final.
Tiempo
Alinee segmentos con timestamps.
Huecos
Caídas/retención pueden crear huecos.
Caché
Se pueden cachear con claves seguras.
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.