快照

快照保存事件中的关键静态画面，适合通知缩略图、Review 预览和人工核查。它与录像保留策略独立：可以保留录像较短、快照较长，或反过来。

示例

snapshots:
  enabled: true
  clean_copy: true
  timestamp: false
  bounding_box: true
  retain:
    default: 10

常用选项

clean_copy：保存未叠加框/文字的干净图像，便于二次识别。
bounding_box：在展示图上绘制目标框。
timestamp：按需要显示时间戳。
retain：控制快照保存时间，注意存储空间和隐私要求。

质量来源

快照质量取决于用于生成事件图像的帧。如果 detect 流分辨率很低，快照可能不适合人脸/车牌人工查看；这时应评估是否需要更高的分析分辨率或使用录像帧进行后续处理。

排查

有事件无快照：确认 snapshots.enabled 以及事件类型是否产生可保存的对象。
快照太模糊：检查源流、detect 分辨率和目标尺寸。
磁盘增长过快：缩短 retain 或减少不必要的事件。

Snapshots

Snapshots keep representative still images for notifications, Review previews, and manual inspection. Snapshot retention is independent of recording retention.

Example

snapshots:
  enabled: true
  clean_copy: true
  timestamp: false
  bounding_box: true
  retain:
    default: 10

Common options

clean_copy keeps an unannotated image for later processing.
bounding_box draws the tracked-object box on the presentation image.
timestamp adds a timestamp when desired.
retain controls storage duration and should reflect privacy/storage policy.

Image quality

Snapshot quality is limited by the frame used to generate it. A very small detect stream may not be suitable for manual face or plate inspection.

Troubleshooting

Events but no snapshots: check snapshots.enabled and event eligibility.
Blurred snapshots: verify source quality, detect resolution, and target size.
Fast disk growth: shorten retention or reduce unnecessary events.

Capturas

Las capturas guardan imágenes representativas para notificaciones, Review y comprobación manual. Su retención es independiente de la grabación.

Ejemplo

snapshots:
  enabled: true
  clean_copy: true
  timestamp: false
  bounding_box: true
  retain:
    default: 10

Opciones

clean_copy conserva una imagen sin anotaciones.
bounding_box dibuja el cuadro.
timestamp añade fecha/hora.
retain controla el tiempo de conservación.

Calidad

La calidad depende del fotograma utilizado; un stream detect muy pequeño puede no servir para caras o matrículas.

Problemas

Eventos sin capturas: revise snapshots.enabled.
Capturas borrosas: revise origen, resolución y tamaño del objetivo.
Disco crece rápido: reduzca retención o eventos.