Windows 11下VLC通过UDP协议实现视频流的故障排查与解决

问题场景 #

在Windows系统中使用VLC播放器进行摄像头流传输时，HTTP协议可正常工作，但切换为UDP协议后，接收端打开udp://localhost:8090仅显示黑屏，无法正常播放视频。

测试脚本 #

CAMERA="USB2.0 HD UVC WebCam"
SIZE="640x480"

HTTP="#http{dst=localhost:8080/test.wmv}"
RTSP="#rtp{sdp=rtsp://:8090/test.wmv}"
UDP="#udp{dst=localhost:8090}"

CODEC="venc=x264{preset=veryfast,tune=zerolatency,intra-refresh,sync-lookahead=0,rc-lookahead=0,keyint=25},ab=128"

TRANSCODE="#transcode{$CODEC,scale=auto,acode=none,scode=none}"

SOUT="$TRANSCODE:$HTTP"

/c/Program\ Files/VideoLAN/VLC/vlc.exe -vvv \
  dshow:// :dshow-vdev="$CAMERA" :dshow-adev=none :dshow-sdev=none :dshow-size="$SIZE" \
  --sout "${SOUT}" \
  --no-audio --sout-keep

切换UDP时仅将SOUT改为"$TRANSCODE:$UDP"，但无法正常传输。

日志信息 #

• 传输端日志：

main debug: VLC media player - 3.0.18 Vetinari
main debug: Copyright © 1996-2022 the VideoLAN team
main debug: revision 3.0.18-0-ge9eceaed4d
main debug: configured with /builds/videolan/vlc/extras/package/win32/../../../configure '--enable-update-check' '--enable-lua' '--enable-faad' '--enable-flac' '--enable-theora' '--enable-avcodec' '--enable-merge-ffmpeg' '--enable-dca' '--enable-mpc' '--enable-libass' '--enable-schroedinger' '--enable-realrtsp' '--enable-live555' '--enable-shout' '--enable-goom' '--enable-sse' '--enable-mmx' '--enable-libcddb' '--enable-zvbi' '--disable-telx' '--enable-nls' '--host=x86_64-w64-mingw32' '--with-contrib=../contrib/x86_64-w64-mingw32' '--with-breakpad=https://win.crashes.videolan.org' '--enable-qt' '--enable-skins2' '--enable-dvdread' '--enable-caca' 'host_alias=x86_64-w64-mingw32' 'CFLAGS= ' 'CXXFLAGS= ' 'PKG_CONFIG=pkg-config' 'PKG_CONFIG_LIBDIR=/usr/x86_64-w64-mingw32/lib/pkgconfig:/usr/lib/x86_64-w64-mingw32/pkgconfig'

• 接收端日志：无任何调试信息

故障原因 #

1. UDP裸流缺少元数据：UDP是无连接协议，默认情况下VLC通过UDP发送的是裸RTP包，未携带SDP（会话描述协议）信息。接收端无法获取视频编码格式、分辨率、帧率等关键参数，无法正确解码显示画面。
2. 协议传输机制差异：HTTP流会自动封装并传输媒体元数据，接收端可直接解析；而UDP裸流需要额外的元数据描述才能被识别。

解决方法 #

方法1：生成SDP文件供接收端加载 #

修改UDP输出配置，让VLC生成包含媒体元数据的SDP文件，接收端通过加载该文件识别流参数：

• 修改脚本中的UDP定义：

  UDP="#rtp{dst=localhost,port=8090,sdp=file:///C:/temp/stream.sdp}"
  

• 启动传输端后，VLC会在C:/temp目录下生成stream.sdp文件
• 接收端打开VLC，通过「媒体」→「打开文件」选择该SDP文件即可正常播放

方法2：使用MPEG-TS封装UDP流 #

将UDP流封装为MPEG-TS格式，TS流本身包含完整媒体元数据，接收端可直接识别：

• 修改脚本中的UDP定义：

  UDP="#udp{dst=localhost:8090,mux=ts}"
  

• 保持SOUT="$TRANSCODE:$UDP"，重新启动传输端
• 接收端直接打开udp://localhost:8090即可正常播放

额外检查项 #

• 确认Windows防火墙允许UDP 8090端口的入站/出站流量
• 可尝试升级VLC至最新稳定版本，避免旧版本协议兼容性问题

内容的提问来源于stack exchange，提问作者tribbloid