🎥 泉视 NVR 系统：大华 SDK 设备接入指南

适用项目：ruoyi-qs-nvr

核心依赖：ZLMediaKit 流媒体服务器

本指南将详细介绍如何在泉视 NVR 系统中集成大华设备（摄像头、NVR、DVR）。系统通过独立的 ruoyi-dahua 微服务模块调用大华官方 SDK，实现设备的注册、实时预览流。

---

▶️视频教程

哔哩哔哩地址：ruoyi-qs-nvr 设备接入-大华sdk设备

📋 接入前准备

在开始之前，请确保您已确认以下信息：

1. ZLMediaKit 服务正常运行。
2. ruoyi-zlm 运行成功，连接ZLMediaKit没有问题
3. ruoyi-dahua 运行成功。（在启动 ruoyi-dahua 服务前，必须确保系统能加载大华的底层库文件（DLL/SO）。请根据你的操作系统选择对应步骤。）

---

🚀 接入步骤

泉视系统支持FLV方式。

手动添加设备 (推荐)

1. 登录系统：进入泉视 NVR 后台管理界面。
2. 进入设备管理：点击菜单栏的 【设备管理】。
3. 点击新增：点击左上角 【新增】 按钮。
4. 填写设备信息：
   • 设备名称：自定义（如 大厅摄像头）。
   • 直播流类型：选择 大华SDK。
   • 上线类型：选择 主动添加 或者 主动上线。（主动添加一般是内网，主动上线是公网）
   • IP地址：主动添加 需要填写设备的IP地址，主动上线 需要选择大华设备ID。
   • 端口号：主动添加 默认37777，，主动上线 不固定的端口号。
   • 输入账号和密码
   • 通道号：大华设备通道号，默认为0开始。
5. 点击【确定】，列表查看设备，点击播放设备，即可完成播放。
6. 注意：ruoyi-zlm 运行成功，连接ZLMediaKit没有问题

🛠️ 常见问题与排查

1. 网络拥塞：检查交换机带宽或尝试更换网线。
2. 检查配置：确保 application.yml 中配置的 media.ip 是 ZLM 服务器所在的 IP，且 media.secret 与 ZLM 配置文件中的 api.secret 一致。
3. 设备添加失败，提示 "SDK 初始化失败"：检查大华 SDK 库文件是否正确加载，确保系统环境变量中包含大华 SDK 库文件的路径。
4. 设备状态显示 "离线" 或 "连接超时"：检查设备 IP 地址、端口、账号和密码是否正确，确保设备在线且可以被访问。
5. 视频画面黑屏，但无报错：检查设备是否正常工作，确保设备连接稳定，且 ZLMediaKit 服务器能够正常推流。

📝 补充说明

1. 流媒体节点：如果设备数量庞大，建议配置多个 ZLMediaKit 节点，负载均衡。