YOLO 实时检测插件

插件简介

本插件同样基于后端模块 hertz_studio_django_yolo，专注于实时流式场景，为摄像头、RTSP/RTMP 视频流提供持续的目标检测与结果推送能力。

• 支持对单路或多路摄像头/视频流进行实时目标检测；
• 支持配置检测帧率、分辨率和缓冲策略，兼顾实时性与资源占用；
• 支持检测结果通过 WebSocket、事件总线等方式推送到前端实时展示；
• 可与告警模块联动，对检测到的异常目标立即触发告警或联动动作。

安装步骤

1. 后端安装（Django）

在部署 Hertz System 的后端虚拟环境中，通过公司私有 PyPI 源安装 YOLO 实时检测依赖：

pip install  hertz-studio-django-yolo -i https://username:password@hzpypi.hzsystems.cn/simple/

安装完成后，在项目的 settings.py 中注册应用（如前所述）：

INSTALLED_APPS += [
    "hertz_studio_django_yolo",
]

2. 前端集成

在管理端菜单中增加「YOLO 实时检测」入口，进入实时监控看板页面。前端通过 WebSocket 或轮询接口订阅实时检测结果，并以叠加框、轨迹等方式展示在视频画面上。

可以在页面中支持切换监控通道、暂停/继续检测、关注某些特定类别等交互，以满足不同业务场景需求。

3. 配置实时检测参数（示例）

根据实际部署情况，在配置中心或环境变量中设置实时检测相关参数，例如：

YOLO_RT_STREAM_URL=rtsp://your-camera/stream
YOLO_RT_FPS=10
YOLO_RT_PUSH_CHANNEL=ws://your-domain/ws/yolo/

上述配置仅作示例，具体取决于你的摄像头地址、网络环境以及后端实时检测服务的实现方式。

使用教程

1. 配置摄像头/视频流

在系统的「设备管理」「摄像头管理」等模块中录入需要接入的摄像头或视频流地址，并与 YOLO 实时检测插件进行关联。

2. 打开实时监控看板

进入「YOLO 实时检测」看板，选择需要查看的通道，系统会自动拉起视频并叠加检测结果，可支持多通道轮播或分屏展示。

3. 结合告警与记录

可将实时检测产生的事件写入告警中心或日志管理插件中，形成可追溯的告警记录，用于后续排查和报表分析。