Skip to content

核查 ​

Frigate 界面中的核查页面用于快速查看摄像头录制到的历史感兴趣片段。核查条目 在垂直时间轴上显示,并以预览网格形式呈现——这些是经过带宽优化的低帧率、低分辨率视频。将鼠标悬停或滑动预览会播放视频并将其标记为已核查。如果需要更深入的分析,可以点击预览,将显示全帧率、全分辨率的完整录像。

核查条目可按日期、目标类型和摄像头进行筛选。

核查条目 vs 被追踪目标(原"事件") ​

在 Frigate 0.13 及更早版本中,界面显示的是"事件"。一个事件等同于一个被追踪或检测到的目标。在 Frigate 0.14 及更高版本中,核查条目是一个时间段,其中可能有任意数量的被追踪目标处于活动状态。

举例来说,假设有两个人从你家门前走过,其中一人牵着一条狗。与此同时,一辆汽车从他们身后的街道驶过。

在此场景下,Frigate 0.13 及更早版本会在界面中显示 4 个"事件"——每个人一个,狗一个,汽车一个。即使这些事件在时间上重叠,你也需要分别观看 4 段视频。

在 0.14 及更高版本中,所有这些活动都被合并成一个单独的核查条目,其开始和结束时间涵盖了所有这些活动。同一摄像头的核查条目不会重叠。一旦你观看了该摄像头的那段时间录像,它就会被标记为已核查。

警报与检测 0.14.0 和 以上版本 ​

Frigate 录制的每段视频对你的重要程度可能有所不同。比如,进入你私人领地的人可能比在人行道上走过的人更值得关注。因此,Frigate 将核查条目分类为 警报 和 检测。默认配置下,所有 person 和 car 都被视为警报。你可以通过配置所需区域来细化核查条目的分类。

NOTE

警报和检测会对核查条目中被追踪的目标进行分类,但 Frigate 必须首先通过你配置的检测器(如 Coral、OpenVINO 等)检测到这些目标才能进行分类。默认情况下,目标跟踪器仅检测 person。设置 alerts 和 detections 的 labels 不会自动启用新目标的检测。要检测更多目标,你应在全局或摄像头配置中添加更多标签:

yaml
objects:
  track:
    - person
    - car
    - ...

关于 Frigate 默认模型可追踪的目标列表,请参阅目标文档。

限制警报的标签类型 ​

默认情况下,只有当检测到 person 或 car 时,核查条目才会被标记为警报。配置警报标签以包含任何目标或音频标签。

在全局或摄像头配置的 核查 部分的 警报配置 中,选择触发警报的标签。

步骤 1 / 1查找警报标签
设置

核查

控制界面与存储所使用的警报、检测和生成式 AI 核查总结的相关设置。

阅读文档
开启生成式 AI 描述

为核查项开启或关闭使用生成式 AI 生成描述和摘要。

警报标签
5 个标签已选择

符合警报条件的目标标签列表(例如:car、person)。

限制检测的标签类型 ​

默认情况下,所有不符合警报条件的检测将被归类为检测。但你可以进一步过滤检测,仅包含特定标签或特定区域。

在 核查 部分的 检测配置 中,选择保留为检测的标签。

步骤 1 / 1查找检测标签
设置

核查

控制界面与存储所使用的警报、检测和生成式 AI 核查总结的相关设置。

阅读文档
开启生成式 AI 描述

为核查项开启或关闭使用生成式 AI 生成描述和摘要。

检测标签
2 个标签已选择

符合检测事件条件的目标标签列表。

从警报或检测中排除摄像头 ​

要从警报或检测中排除特定摄像头,在摄像头级别的警报或检测标签字段提供一个空列表。

例如,要排除摄像头 gatecamera 的所有检测:

yaml
cameras:
  gatecamera:
    review:
      detections:
        labels: []

手动事件分类 ​

通过创建手动事件 API创建的事件使用相同的标签列表进行分类,并使用请求路径中的标签:

  1. 如果启用了警报且标签在 review -> alerts -> labels 中,则核查条目为警报。
  2. 否则,如果启用了检测且标签在 review -> detections -> labels 中,则核查条目为检测。
  3. 如果标签不在任一列表中,则核查条目为警报;如果警报被禁用,则不创建核查条目。

这意味着手动事件默认为警报,除非你明确将其标签列为检测标签。例如,要让 PIR 传感器创建检测而不是警报,请向 /api/events/front_door/pir_sensor/create 发起请求,并配置如下:

yaml
cameras:
  front_door:
    review:
      detections:
        labels:
          - pir_sensor

NOTE

必需区域不适用于手动事件,因为手动事件是通过 API 创建的,而非由目标跟踪器创建。将 review -> alerts -> labels 设置为空列表也不会阻止手动事件成为警报,因为标签不在任一列表中时仍会回退为警报。

将核查条目限制在特定区域 ​

默认情况下,如果在摄像头画面的任何位置检测到 review -> alerts -> labels 和 review -> detections -> labels 中的目标,就会创建一个核查条目。你可能希望配置为仅当目标进入关注区域时才创建核查条目,详见区域文档

信息

由于区域不适用于音频,音频标签默认始终标记为检测。

核查画面变动 ​

核查页面还可以显示未产生追踪目标的画面变动时段,并允许你在绘制的区域内搜索过去录像中的画面变动。有关如何使用画面变动预览和画面变动搜索,请参阅使用文档中的核查画面变动;有关底层画面变动检测器的配置,请参阅调整画面变动检测。