运动检测

运动检测负责决定“画面哪里发生了变化”，它不是目标识别。Securex NVR 通常先用运动检测缩小需要送入对象检测器的区域，因此运动参数过严会漏掉目标，过松则增加检测负担。

调优顺序

打开 Debug 中的 Motion Boxes。
观察树叶、雨雪、阴影、时间戳、自动曝光等是否持续产生运动框。
先用 motion mask 去掉固定无意义区域，例如时间戳或天空。
只有在仍然噪声很多时，再调整 threshold、contour area 等参数。

Motion Mask 与 Object Mask 的区别

Motion mask 只阻止该区域的画面变化触发运动；它并不保证对象“不会被检测”。如果对象因为其他未遮罩区域的运动而进入检测流程，仍可能被识别。要限制业务区域，通常应使用 Zone + required_zones。

示例

cameras:
  front:
    motion:
      threshold: 30
      contour_area: 20
      improve_contrast: true
      mask:
        timestamp:
          friendly_name: Camera timestamp
          enabled: true
          coordinates: "0.00,0.00,0.35,0.00,0.35,0.08,0.00,0.08"

夜间与低照度

夜间噪点、IR 切换、车灯和自动曝光会产生大量变化。优先改善摄像头曝光、码率和补光，再调软件阈值。过度提高 threshold 可能让远处缓慢移动的人无法触发检测。

验证

理想状态是：静止画面几乎没有持续运动框；人物/车辆出现时运动框能覆盖其路径；CPU/Detector 负载不会因树叶或时间戳长期维持高位。

Motion detection

Motion detection answers “where did pixels change?”; it is not object recognition. Securex NVR uses motion to focus object detection work, so overly strict motion tuning can miss objects while overly sensitive tuning wastes detector time.

Tuning order

Enable Motion Boxes in Debug.
Observe foliage, rain, shadows, timestamps, and exposure changes.
Mask fixed nuisance areas first.
Only then tune threshold or contour area.

Motion masks vs object masks

A motion mask suppresses motion triggers in that region; it does not guarantee an object can never be detected there. For business logic, zones and required zones are usually the better tool.

Example

cameras:
  front:
    motion:
      threshold: 30
      contour_area: 20
      improve_contrast: true
      mask:
        timestamp:
          friendly_name: Camera timestamp
          enabled: true
          coordinates: "0.00,0.00,0.35,0.00,0.35,0.08,0.00,0.08"

Low light

Sensor noise, IR switching, headlights, and auto exposure can generate large pixel changes. Improve camera exposure and illumination before making motion thresholds excessively strict.

Verify

A good configuration shows little persistent motion in a static scene, reliably follows people/vehicles, and does not keep the detector busy because of a timestamp or moving trees.

Detección de movimiento

La detección de movimiento indica dónde cambian los píxeles; no identifica objetos. Securex NVR la usa para concentrar el trabajo del detector.

Orden de ajuste

Active Motion Boxes en Debug.
Observe árboles, lluvia, sombras, timestamp y cambios de exposición.
Enmascare primero zonas fijas sin valor.
Después ajuste threshold o contour area.

Motion mask frente a object mask

Una motion mask evita que esa zona dispare movimiento, pero no garantiza que un objeto nunca sea detectado allí. Para lógica de negocio suelen ser mejores las zonas y required_zones.

Ejemplo

cameras:
  front:
    motion:
      threshold: 30
      contour_area: 20
      improve_contrast: true
      mask:
        timestamp:
          friendly_name: Camera timestamp
          enabled: true
          coordinates: "0.00,0.00,0.35,0.00,0.35,0.08,0.00,0.08"

Poca luz

Ruido, cambio IR, faros y autoexposición generan cambios grandes. Mejore la cámara antes de endurecer demasiado el umbral.

Verificación

Una escena quieta no debe producir cajas persistentes, mientras personas y vehículos deben activar movimiento de forma fiable.