摄像头配置

摄像头是 Securex NVR 的核心配置单元。建议把“取流、检测、录像、实时查看”分开理解：go2rtc 负责稳定转流，FFmpeg 负责解码/录像，detect 流提供 AI 检测帧，record 流提供高质量录像。

建议的流设计

主码流：高分辨率、高码率，用于 record。
子码流：较低分辨率与帧率，用于 detect，可明显降低解码与 AI 开销。
实时查看：优先复用 go2rtc 的 restream/WebRTC/MSE，避免每个客户端都直接连接摄像头。

最小示例

cameras:
  front:
    enabled: true
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/front
          input_args: preset-rtsp-restream
          roles:
            - detect
            - record
    detect:
      width: 1280
      height: 720
      fps: 5
    record:
      enabled: true

roles 的含义

role	用途
detect	提供给运动检测和目标检测的画面。
record	提供录像片段，通常应使用质量更高的码流。
audio	当配置需要单独处理音频时使用；具体支持取决于版本和输入。

detect 分辨率与 FPS

检测分辨率决定送入运动/目标检测管线的画面尺寸。不要为了“更清晰”盲目使用 4K 检测；大多数场景 5 FPS 已足够进行人员与车辆检测。需要识别高速运动、车牌或很小目标时，再根据实际场景提高分辨率或帧率。

上线前检查

确认 RTSP/HTTP 源在摄像头本身稳定。
确认 go2rtc 中可持续播放。
确认 FFmpeg 日志没有反复重连、解码错误或时间戳错误。
确认 detect FPS 与 inference speed 能匹配。
最后再开启录像、Review、通知和高级识别。

常见问题

画面能看但没有检测：检查该输入是否有 detect role，以及 detect 是否启用。
有检测但录像黑屏/缺片：检查 record role 与录像流编码。
CPU 很高：优先检查是否启用了硬件解码，以及 detect 流是否过大。
摄像头连接数过多：用 go2rtc restream 统一复用源流。

Camera configuration

A camera is the main configuration unit in Securex NVR. Treat acquisition, detection, recording, and live viewing as separate layers: go2rtc stabilizes/restreams sources, FFmpeg decodes and records, the detect stream feeds analytics, and the record stream preserves quality.

Recommended stream design

Main stream: high resolution/bitrate for recording.
Sub stream: lower resolution and frame rate for detection to reduce decode and inference cost.
Live viewing: reuse go2rtc restream/WebRTC/MSE so each client does not open another direct session to the camera.

Minimal example

cameras:
  front:
    enabled: true
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/front
          input_args: preset-rtsp-restream
          roles:
            - detect
            - record
    detect:
      width: 1280
      height: 720
      fps: 5
    record:
      enabled: true

Input roles

Role	Purpose
detect	Frames used by motion and object detection.
record	Source used for recorded media, normally the higher-quality stream.
audio	Used where the configuration handles audio separately; support depends on the input and build.

Detection resolution and FPS

Detection resolution controls the image entering the analysis pipeline. Do not use 4K detection simply because the source is 4K. Around 5 FPS is enough for many person/vehicle scenarios; increase resolution or frame rate only when the scene actually requires it, such as small targets or fast vehicles.

Commissioning checklist

Verify the camera source itself is stable.
Verify continuous playback in go2rtc.
Check FFmpeg logs for reconnect loops or decode/timestamp errors.
Confirm detection FPS and inference speed can keep up.
Only then enable recording, Review, notifications, and enrichments.

Common issues

Video works but no detections: check the detect role and detect enablement.
Detections work but recordings fail: inspect the record role and codec of the recording stream.
High CPU: verify hardware decoding and reduce detect-stream workload.
Too many camera sessions: restream through go2rtc.

Configuración de cámaras

La cámara es la unidad principal de Securex NVR. Conviene separar captura, detección, grabación y visualización: go2rtc estabiliza y redistribuye streams, FFmpeg decodifica/graba, el stream detect alimenta el análisis y record conserva la calidad.

Diseño recomendado

Stream principal: alta resolución para grabación.
Substream: menor resolución/FPS para detección.
Vista en vivo: reutilice go2rtc con restream/WebRTC/MSE para evitar conexiones directas adicionales.

Ejemplo mínimo

cameras:
  front:
    enabled: true
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/front
          input_args: preset-rtsp-restream
          roles:
            - detect
            - record
    detect:
      width: 1280
      height: 720
      fps: 5
    record:
      enabled: true

Roles

Rol	Uso
detect	Fotogramas para movimiento y detección de objetos.
record	Fuente para grabación, normalmente de mayor calidad.
audio	Procesamiento de audio cuando la compilación y la entrada lo admiten.

Resolución y FPS

No use 4K para detección solo porque la cámara lo ofrece. En muchos casos unos 5 FPS bastan; aumente resolución/FPS únicamente cuando el tamaño o la velocidad del objetivo lo exijan.

Lista de puesta en marcha

Compruebe el origen de cámara.
Compruebe reproducción continua en go2rtc.
Revise errores de FFmpeg.
Verifique que FPS de detección e inferencia sean sostenibles.
Después active grabación, Review, notificaciones y enriquecimientos.

Problemas frecuentes

Hay vídeo pero no detección: revise role detect.
Hay detección pero falla grabación: revise role record y códec.
CPU alta: active aceleración y reduzca el stream detect.
Demasiadas sesiones: redistribuya con go2rtc.