结论:原生h.264裸流无法直接通过mediasource api播放,因浏览器仅支持含时间戳、轨道信息和moov/moof结构的fmp4等分片容器格式;wfs.js等库需先解析nalu并重封装为fmp4才能appendbuffer。

直接说结论:用 WebSocket 播放原始 H.264 流(裸流)在现代浏览器中不可行,必须封装为浏览器能识别的容器格式(如 fMP4、FLV、MPEG-TS),否则 MediaSource 无法 append,video 标签会静音或报错。
为什么原生 H.264 裸流不能直接喂给 video 标签
浏览器的 MediaSource API 不接受裸 H.264 NALU 流。它只认“有时间戳、有轨道信息、有 moov/moof 结构”的分片媒体(如 fMP4)。wfs.js 看似在处理 H.264,实则内部做了两件事:h264Demuxer 解析 NALU 类型并打时间戳,MP4Remuxer 把它们打包成可 append 的 fMP4 片段。若跳过 remux 步骤,直接把 raw H.264 丢进 sourceBuffer.appendBuffer(),你会看到如下错误:
Failed to execute 'appendBuffer' on 'SourceBuffer': The provided ArrayBuffer is not valid.- 控制台无报错但
video一直黑屏或卡在 loading 状态 -
sourceBuffer.updating长时间为true,且sourceBuffer.buffered.length === 0
wfs.js 中关键参数 H264_TIMEBASE 怎么调才准
这个值不是“越大越慢”的模糊经验数,而是决定时间戳精度的核心分母。它代表「1 秒被划分成多少个 tick」,直接影响 PTS/DTS 计算。设帧率为 fps,理想值应为 Math.floor(90000 / fps)(因为 MSE 默认使用 90kHz 时间基):
- 25fps →
H264_TIMEBASE = 3600(90000 ÷ 25) - 30fps →
H264_TIMEBASE = 3000(90000 ÷ 30) - 若服务端送帧不稳(如偶发丢帧、重复帧),可微调 ±200 补偿抖动
- 硬写死
4500是为适配某些低帧率(20fps)或带 B 帧的编码器,但会引入约 120ms 累计偏移
改完后务必检查 MP4Remuxer.prototype._onVideoData 中生成的 sample.duration 是否接近预期(如 25fps 下应 ≈ 3600)。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。
WebSocket 断连重连时如何避免花屏/卡顿
wfs.js 默认不处理重连逻辑,断连后 mediaSource 仍处于 open 状态但无新数据,video 会卡在最后一帧或自动 seek 到开头。必须手动干预:
- 监听
websocket.onclose,立即执行mediaSource.endOfStream()+media.pause() - 重连成功后,先
mediaSource.remove(0, media.duration)清空旧缓冲区 - 再调用
mediaSource.addSourceBuffer('video/mp4; codecs="avc1.42E01E"')重建sourceBuffer - 注意:重建前确保
mediaSource.readyState === 'closed',否则会报InvalidStateError
很多项目漏掉 remove() 这步,导致新老帧时间戳冲突,画面撕裂或解码失败。
生产环境必须开 WSS,且 FFmpeg 推流参数要对齐
HTTP 协议下 WebSocket 可能被中间代理截断或复用连接,导致流中断;而 WSS(WebSocket Secure)走 TLS 443 端口,穿透性更好。更重要的是,FFmpeg 输出格式必须与前端解析器严格匹配:
- 用 wfs.js → 后端必须推 H.264 Annex-B 格式(NALU 前缀为
00 00 00 01),不能是 AVCC(带 length header) - 用 jsmpeg → 必须转 MPEG1 视频 + MP2 音频,封装为 MPEG-TS,且
-fflags +nobuffer -flags +low_delay不可少 - 用 flv.js → 必须输出 FLV 封装,且 keyframe interval(GOP)建议 ≤ 2s,否则首屏加载慢
最容易被忽略的一点:服务端时间戳(DTS/PTS)必须单调递增且连续。FFmpeg 若未加 -vsync cfr 或 -copyts,遇到网络抖动时可能倒退,前端 remuxer 会直接丢弃该帧。










