FFmpeg录制WebM直播流报错：编解码器参数不符合要求

我们有一个支持摄像头/屏幕直播、观众观看的直播平台，主播通过FFmpeg将直播流录制为WebM格式。之前录制命令正常运行，但近期出现以下报错：

Only VP8 or VP9 or AV1 video and Vorbis or Opus audio and WebVTT subtitles are supported for WebM.
Could not write header for output file #0 (incorrect codec parameters ?): Invalid argument

使用的FFmpeg命令：

ffmpeg -loglevel debug -protocol_whitelist pipe udp rtp 
-fflags+genpts -f sdp -i pipe:0 -map 0:v:0 -c:v copy 
-map 0:a:0 -strict -2 -c:a copy -flags +global_header 1234_VIDEO_1671647432529.webm  

服务器环境：

• 服务器（EC2）：AWS Linux 2
• FFmpeg版本：4.3.2-static

问题根源 #

报错明确说明WebM容器仅支持VP8/VP9/AV1视频编码、Vorbis/Opus音频编码以及WebVTT字幕。之前命令能正常运行，是因为当时输入直播流的音视频编码刚好符合WebM要求；现在报错，说明当前输入流的音视频编码不在WebM支持范围内，而你用了-c:v copy和-c:a copy直接复制原编码，导致输出格式不兼容。

解决方案 #

需要将输入流的音视频转码为WebM支持的编码格式，而非直接复制原编码。

1. 转码为VP8视频+Opus音频（兼容性优先）

修改命令，替换原复制编码的参数为转码参数：

ffmpeg -loglevel debug -protocol_whitelist pipe udp rtp 
-fflags+genpts -f sdp -i pipe:0 -map 0:v:0 -c:v libvpx -crf 10 -b:v 1M 
-map 0:a:0 -c:a libopus -b:a 128k -flags +global_header 1234_VIDEO_1671647432529.webm  

• -c:v libvpx：指定使用VP8视频编码（WebM标准兼容编码）
• -crf 10：控制视频质量，数值越小质量越高（范围0-63），10是兼顾质量和体积的常用值
• -b:v 1M：设置视频比特率，可根据直播流分辨率调整（比如1080p可设为2M）
• -c:a libopus：指定使用Opus音频编码（WebM推荐的高效音频编码）
• -b:a 128k：设置音频比特率，适合大多数直播场景

2. 转码为VP9视频（高压缩率优先）

如果需要更高压缩比的视频文件（适合高分辨率直播），可以改用VP9编码：

ffmpeg -loglevel debug -protocol_whitelist pipe udp rtp 
-fflags+genpts -f sdp -i pipe:0 -map 0:v:0 -c:v libvpx-vp9 -crf 20 -b:v 0 
-map 0:a:0 -c:a libopus -b:a 128k -flags +global_header 1234_VIDEO_1671647432529.webm  

• -c:v libvpx-vp9：指定使用VP9编码
• -crf 20 -b:v 0：仅用CRF控制视频质量，不限制比特率，VP9的CRF范围0-63，20为平衡质量和体积的常用值

3. 排查输入流编码格式

如果想确认当前直播流的音视频编码，可以先运行以下命令查看详情：

ffmpeg -loglevel info -protocol_whitelist pipe udp rtp -fflags+genpts -f sdp -i pipe:0

输出中会显示Stream #0:0（视频流）和Stream #0:1（音频流）的编码信息，可确认是否为WebM不支持的格式（比如H.264视频、AAC音频等）。

额外说明 #

• 之前正常现在报错的原因：大概率是近期主播端的推流编码发生了变化（比如从VP8切换为H.264），导致直接复制编码时触发格式不兼容报错。
• 原命令中的-strict -2参数可以移除，因为Opus是FFmpeg完全支持的编码，无需兼容模式。

内容的提问来源于stack exchange，提问作者Not A Robot