LibVLCSharp播放短音频/视频时无法完整播放问题求助

问题描述 #

在C# WPF项目中使用LibVLCSharp v3.8.1.0播放时长仅几秒的mp3/mp4短音视频时，会出现播放不完整的情况——媒体在接近播放结束前自动暂停。该问题仅针对极短媒体文件出现，官方及相关社区暂未找到直接解决方案，经官方示例验证仍存在此问题。

复现代码 #

_libVLC = new LibVLC();
using (var media = new Media(_libVLC, new Uri("local-short-media.mp3")))
parent.VideoView.MediaPlayer.Play(media);

VLC调试日志（翻译后） #

main 调试：未匹配到stream_filter模块
main 调试：寻找匹配"any"的stream_directory模块：1个候选
main 调试：未匹配到stream_directory模块
main 调试：为file:///C:/Users/bigq5/Desktop/conversion_1696831409386.mp3挂载目录提取器失败
main 调试：寻找匹配"record"的stream_filter模块：24个候选
main 调试：使用stream_filter模块"record"
main 调试：创建解复用器：access='file' demux='any' location='/C:/Users/bigq5/Desktop/conversion_1696831409386.mp3' file='C:\Users\bigq5\Desktop\conversion_1696831409386.mp3'
main 调试：寻找匹配"any"的demux模块：55个候选
es 调试：检测到格式mpga
main 调试：寻找匹配"any"的packetizer模块：25个候选
main 调试：使用packetizer模块"mpegaudio"
mpegaudio 调试：MPGA声道数：1 采样率：24000 比特率：160
main 调试：选择节目id=0
main 调试：使用demux模块"es"
main 调试：在C:\Users\bigq5\Desktop\中寻找字幕文件
main 调试：寻找匹配"any"的音频解码器模块：23个候选
mpg123 调试：mpga->f32l，采样位数：32
main 调试：使用音频解码器模块"mpg123"
main 调试：寻找匹配"any"的元数据读取模块：2个候选
lua 调试：尝试在C:\Users\bigq5\AppData\Roaming\vlc\lua\meta\reader中加载Lua脚本
lua 调试：尝试在F:\ENJavaSpace\OneClassMix\OneClassMix\bin\Debug\libvlc\win-x86\lua\meta\reader中加载Lua脚本
lua 调试：尝试加载Lua播放列表脚本F:\ENJavaSpace\OneClassMix\OneClassMix\bin\Debug\libvlc\win-x86\lua\meta\reader\filename.luac
main 调试：未匹配到元数据读取模块
main 调试：`file:///C:/Users/bigq5/Desktop/conversion_1696831409386.mp3'成功打开
main 调试：缓冲0%
main 调试：缓冲2%
main 调试：缓冲4%
main 调试：缓冲7%
main 调试：缓冲12%
main 调试：缓冲9%
main 调试：缓冲14%
main 调试：缓冲16%
main 调试：缓冲19%
main 调试：缓冲21%
main 调试：复用音频输出
directsound 调试：打开DirectSound音频输出
main 调试：缓冲24%
main 调试：缓冲26%
main 调试：缓冲28%
main 调试：缓冲31%
main 调试：缓冲36%
main 调试：缓冲33%
main 调试：缓冲38%
main 调试：缓冲40%
main 调试：缓冲43%
main 调试：缓冲45%
main 调试：缓冲48%
main 调试：缓冲50%
main 调试：缓冲52%
main 调试：缓冲55%
main 调试：缓冲57%
main 调试：缓冲60%
main 调试：缓冲62%
main 调试：缓冲64%
main 调试：缓冲67%
main 调试：缓冲69%
main 调试：缓冲74%
main 调试：缓冲72%
main 调试：缓冲76%
main 调试：缓冲81%
main 调试：缓冲79%
main 调试：缓冲84%
main 调试：缓冲86%
main 调试：缓冲88%
main 调试：缓冲91%
main 调试：缓冲93%
main 调试：缓冲96%
main 调试：缓冲98%
main 调试：流缓冲完成（1008毫秒耗时15毫秒）
directsound 调试：Windows扬声器配置：四声道，流为1声道，使用1声道
main 调试：输出格式'f32l' 24000 Hz 立体声 帧=1采样/8字节
main 调试：寻找匹配"any"的音频音量模块：2个候选
main 调试：使用音频音量模块"float_mixer"
main 调试：输入格式'f32l' 24000 Hz 单声道 帧=1采样/4字节
main 调试：寻找匹配"scaletempo"的音频滤镜模块：16个候选
scaletempo 调试：格式：24000采样率，1声道，4字节/采样，fl32
scaletempo 调试：参数：30步长，0.200重叠，14搜索
scaletempo 调试：缩放比例1.000，输入步长720.000，输出步长720，静态帧576，重叠144，搜索336，队列1200，fl32模式
main 调试：使用音频滤镜模块"scaletempo"
main 调试：格式转换：'f32l'->'f32l' 24000 Hz->24000 Hz 单声道->单声道
main 调试：转换流水线完成
main 调试：格式转换：'f32l'->'f32l' 24000 Hz->24000 Hz 单声道->立体声
main 调试：寻找匹配"any"的音频转换模块：8个候选
main 调试：使用音频转换模块"trivial"
main 调试：转换流水线完成
main 调试：寻找匹配"any"的音频重采样模块：3个候选
main 调试：使用音频重采样模块"samplerate"
main 调试：解码器等待完成，耗时33毫秒
main 调试：到达文件末尾（EOF）
main 调试：在EOF处暂停（每次播放结束后暂停）
main 调试：切换恢复状态

解决方案 #

从日志中可以看到，播放暂停是因为VLC默认启用了“播放结束后暂停”的逻辑，对于极短文件，该逻辑可能提前触发导致播放不完整。可以通过以下两种方式解决：

方法1：初始化LibVLC时禁用“结束后暂停”参数 #

在创建LibVLC实例时添加--no-pause-on-end参数，禁止媒体播放到末尾时自动暂停：

// 添加参数禁用播放结束后暂停
_libVLC = new LibVLC("--no-pause-on-end");
using (var media = new Media(_libVLC, new Uri("local-short-media.mp3")))
parent.VideoView.MediaPlayer.Play(media);

方法2：监听播放结束事件手动处理 #

注册EndReached事件，在媒体播放完成时自行处理状态，避免提前暂停：

_libVLC = new LibVLC();
var mediaPlayer = parent.VideoView.MediaPlayer;
// 注册播放结束事件
mediaPlayer.EndReached += (sender, args) =>
{
    // 可以在这里重置播放状态或执行后续操作
    mediaPlayer.Stop();
};
using (var media = new Media(_libVLC, new Uri("local-short-media.mp3")))
{
    mediaPlayer.Play(media);
}

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