🎥 泉视 NVR 系统：HLS 视频流播放指南

适用项目：ruoyi-qs-nvr

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

本指南将详细介绍如何在泉视 NVR 系统中处理 HLS (Flash Video) 格式。

---

▶️视频教程

哔哩哔哩地址：ruoyi-qs-nvr 设备接入-hls设备

📋 接入前准备

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

1. ZLMediaKit 服务正常运行。
2. ruoyi-zlm 运行成功，连接ZLMediaKit没有问题

---

🧩 HLS 流地址标准格式

示例：
https://devimages.apple.com.edgekey.net/iphone/samples/bipbop/bipbopall.m3u8

🚀 接入步骤

泉视系统支持HLS方式。

手动添加设备 (推荐)

1. 登录系统：进入泉视 NVR 后台管理界面。
2. 进入设备管理：点击菜单栏的 【设备管理】。
3. 点击新增：点击左上角 【新增】 按钮。
4. 填写设备信息：
   • 设备名称：自定义（如 大厅摄像头）。
   • 直播流类型：选择 HLS。
5. 填写流地址 (关键步骤)：
   • 直播地址填HLS地址。
6. 点击【确定】，列表查看设备，点击播放设备，即可完成播放。
7. 注意：ruoyi-zlm 运行成功，连接ZLMediaKit没有问题

🛠️ 常见问题与排查

1. URL 错误：复制 HLS 地址到 VLC 播放器 中测试。如果 VLC 也无法播放，说明地址错误。
2. 网络拥塞：检查交换机带宽或尝试更换网线。
3. 检查配置：确保 application.yml 中配置的 media.ip 是 ZLM 服务器所在的 IP，且 media.secret 与 ZLM 配置文件中的 api.secret 一致。

📝 补充说明

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