Export API
导出 API 用于把指定摄像头/时间范围生成独立视频文件。导出通常需要后台处理,因此客户端应显示任务状态而不是假设立即完成。
核心说明
本页内容按该功能本身整理,不再使用通用占位说明。以下项目均与当前主题直接相关。
参数
明确摄像头、起止时间、名称和可选编码参数。
硬件编码
若启用了视频硬件加速,导出可使用硬件编码;硬件不可用时应按服务器策略失败或回退。
状态
创建成功不等于文件已经可下载;应轮询状态或等待任务完成通知。
安全
不要允许普通客户端随意传入可访问主机文件系统的 FFmpeg 参数。
验证与排查
- 修改或执行前记录当前版本/配置,以便回退。
- 完成后同时检查 UI 状态和后端日志,不只看一个成功提示。
- 如果问题只在单个摄像头/插件出现,先做最小范围对比,避免全局改动。
Export API
Export APIs create standalone clips from a camera/time range and may run asynchronously.
Core behavior
This page is topic-specific rather than a generic placeholder.
Parameters
Provide camera, time range, name and optional encode settings.
Hardware encoding
Exports may use configured hardware encoding with server-defined fallback behavior.
Status
Creation success does not mean the file is ready.
Security
Restrict dangerous FFmpeg arguments for untrusted users.
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.
Export API
La API de exportación crea clips y puede procesarlos de forma asíncrona.
Comportamiento
Esta página contiene contenido específico del tema, no un texto genérico.
Parámetros
Indique cámara, rango, nombre y codificación opcional.
Codificación HW
Puede usar hardware con la política de fallback del servidor.
Estado
Crear tarea no implica archivo listo.
Seguridad
Restrinja argumentos FFmpeg peligrosos.
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.
