必须启用media.peerconnection.enabled并确保https/localhost安全上下文,通过getusermedia或capturestream获取原始流,用about:webrtc查看ice/sdp/媒体统计,配置media.webrtc.debug日志导出详细帧级数据。

要在火狐浏览器中捕获并调试WebRTC音视频推流的底层数据,必须绕过应用层封装直接观察原始媒体流生成、编码前状态及连接协商细节,否则只能看到封装后的统计结果。
确认WebRTC功能已启用并进入安全上下文
打开Firefox地址栏,输入about:config回车,搜索media.peerconnection.enabled,确保其值为true;若被禁用,双击切换为启用状态。
所有WebRTC媒体采集操作(包括getUserMedia和getDisplayMedia)仅在HTTPS或localhost环境下生效,【HTTP非本地域名将直接导致navigator.mediaDevices为undefined】。
捕获原始音视频流(不经过编码压缩)
方法一:使用getUserMedia获取未处理的原始流
在控制台执行以下代码:
navigator.mediaDevices.getUserMedia({video: true, audio: true}).then(stream => { window.localStream = stream; console.log("原始流已捕获", stream); });
这一步拿到的是浏览器从设备驱动读取的原始帧数据,尚未进入编码器,可用于分析采集延迟、帧率抖动或YUV格式异常。
方法二:用captureStream()劫持已有HTML元素输出流
若页面已存在<video id="src"></video>或<canvas></canvas>,可对其调用captureStream(60)——该方法返回的流与getUserMedia不同,它不触发设备权限弹窗,且帧率由源元素渲染节奏决定,【但无法获取音频轨道,除非源元素本身含audio】。
查看实时ICE候选、SDP交换与轨道级统计
第一步:访问内置调试页
在Firefox地址栏输入about:webrtc并回车,页面自动加载当前所有WebRTC连接实例。
第二步:定位目标连接
找到“Active PeerConnections”列表中对应推流的连接项(通常标签含RTCPeerConnection或自定义id),点击右侧“Show Details”展开。
第三步:重点观察三类数据
→ “ICE Stats”里检查candidate-pair状态是否为succeeded,若长期停留在checking说明NAT穿透失败;
→ “SDP”标签页对比local/remote offer/answer,确认video codecs是否包含VP8/VP9/AV1而非仅H.264(某些企业防火墙会过滤H.264 payload type);
→ “Media Statistics”中下拉选择outbound-rtp轨道,查看framesEncoded是否持续增长,若卡在某数值则编码器已崩溃或流被静音。
导出完整WebRTC日志用于离线分析
方法1:启用详细日志输出
在about:config中新建布尔型配置项media.webrtc.debug.aec_dump_enabled,设为true;再新建整数型配置项media.webrtc.debug.log_file_path,值设为绝对路径如/tmp/webrtc_log.txt(Linux/macOS)或C:\webrtc\log.txt(Windows)。
方法2:触发日志捕获
重启Firefox → 打开推流页面 → 在about:webrtc页点击“Start Logging”按钮 → 完成推流测试后点击“Stop Logging” → 日志文件即刻写入指定路径。
该日志包含每一帧采集时间戳、编码耗时、NALU包拆分详情、RTP序列号跳变等,是定位花屏、卡顿、首帧延迟的根本依据。











