html5_rtsp_player(Streamedian)是目前唯一成熟开箱即用的浏览器端RTSP解析方案,通过JS库实现协议解析与MSE注入,不转码、不丢帧、延迟低。

直接用 html5_rtsp_player(Streamedian)最省事
浏览器原生不支持 RTSP,所以必须靠 JS 库在前端做协议解析 + MSE 注入。目前唯一成熟、开箱即用、且真正在浏览器里解码 RTSP/RTP 的方案就是 html5_rtsp_player(GitHub 上叫 streamedian/html5_rtsp_player)。它不转码、不丢帧、延迟低(通常
常见错误现象:Failed to start player: WebSocket connection failed——说明你漏了后端 WebSocket 代理;或者 appendBuffer failed——多半是 SPS/PPS 没送全或 NALU 起始码格式错(0x00000001 vs 0x000001),但这些 Streamedian 已内部处理好,你不用碰。
- 安装:
npm install git://github.com/Streamedian/html5_rtsp_player.git - HTML 中只需一个
标签,src写 RTSP 地址即可(如rtsp://admin:12345@192.168.1.64:554/stream1) - JS 初始化时必须传
socket地址,指向你的 WebSocket 代理服务(不是摄像头地址!) - 不支持 iOS Safari 和旧版 IE —— 这是 MSE 本身的限制,不是库的问题
ffmpeg 不是播放器,是转码工具链的一环
很多人搜“html5 播放 rtsp ffmpeg”,误以为 ffmpeg 能直接嵌进网页里播。其实它完全不参与前端播放,只负责在服务端把 RTSP 流“翻译”成浏览器能吃的格式:比如 HLS(.m3u8)、HTTP-FLV(配合 flv.js)、或 WebRTC(配 Janus/GStreamer)。它的作用是“搬运工+翻译官”,不是“播放器”。
典型误用:ffmpeg -i rtsp://... -f hls out.m3u8 生成静态切片,结果发现视频卡顿、延迟 10 秒以上——这是因为 HLS 天然有缓冲窗口,不适合监控类实时流。
立即学习“前端免费学习笔记(深入)”;
- 想低延迟?优先选
ffmpeg -i ... -f flv http://127.0.0.1:8080/live+flv.js,延迟可压到 1–2 秒 - 要兼容性最强?用
ffmpeg -i ... -f hls -hls_time 2 -hls_list_size 3,但得接受 6–10 秒延迟 - 别用
-c:v copy直拷贝 H.264 码流进 FLV —— FLV 容器不认 Annex B 格式,会花屏;必须加-vbsf h264_mp4toannexb或用 x264 重编码
别踩坑:WebRTC 方案看着高级,落地反而最重
网上一堆“用 WebRTC 播 RTSP”的教程,听着很现代,但实际要自己搭信令服务器(Janus / mediasoup)、配 STUN/TURN、处理 SDP Offer/Answer、还要写前端 RTCPeerConnection 逻辑。一旦 NAT 穿透失败,用户就黑屏,连报错都难定位。
适用场景非常明确:你已经有 WebRTC 基础设施,且需要多端互通(比如手机 App 也要接入同一路流),否则纯属过度设计。
- Janus 配置里漏了
video_port或没开ice_lite,就会连不上 - 前端调用
peerConnection.addTransceiver('video', { direction: 'recvonly' })忘了设direction,媒体流根本不会进来 - RTSP 源时间戳(RTP timestamp)没对齐 WebRTC 的 clock rate,会导致音画不同步
商业 SDK 是备选,不是首选
像 EasyPlayer、WebSDK for VLC 这类闭源方案,确实封装好了所有细节,一行代码就能播,但代价是:授权费、无法 debug、升级受制于厂商、且多数仍依赖后台转码服务(没解决延迟和画质问题)。
除非项目上线 deadline 小于 3 天,或者团队完全没音视频经验,否则不建议第一选择。Streamedian 开源版已足够稳定,GitHub issue 区活跃,社区也常有现成的 Docker 部署脚本可抄。
最容易被忽略的一点:所有方案都绕不开「WebSocket 代理」这个中间层。它不处理解码,只做 RTP 包的 TCP 封装和转发。哪怕你用 ffmpeg + flv.js,也需要一个轻量代理(比如 ws-relay 或自写 Node.js ws 服务)来桥接 FFmpeg 输出和浏览器。漏掉这层,再好的库也白搭。










