c# 如何播放音频文件

20次阅读

C#播放音频无唯一方案:SoundPlayer仅支持PCM WAV;wpf用MediaElement播MP3/OGG但需XAML;winForms播MP3/OGG需NAudio;调试WAV可用PlaySound P/Invoke。

c# 如何播放音频文件

C# 播放音频文件没有“唯一正确答案”,关键看你要播什么格式、跑在什么平台、是否需要控制(暂停/进度/音量)、以及能否接受第三方依赖。直接结论:System.Media.SoundPlayer 只能播 .wavMediaPlayer(WPF)或 MediaElement 支持 .mp3/.ogg 但仅限 WPF/UWP;真正跨格式、跨平台、可编程控制的方案,几乎必须用 NAudio

只播 WAV?用 SoundPlayer 最快,但有硬限制

它开箱即用,不用装包,适合播放小提示音(比如按钮点击声)。但注意:它不支持流式加载,会把整个 WAV 文件读进内存;且只认 PCM 编码的 WAV,对压缩型(如 ADPCM)、高采样率(>44.1kHz)、非 16-bit 的文件大概率静音或报错。

  • Play()异步的,ui 不卡,但无法监听播放结束
  • PlaySync() 是同步的,线程会等播完才继续,别在 UI 线程调用,否则界面冻结
  • 路径必须是绝对路径或资源嵌入路径(不能直接用相对路径如 "sound.wav"
using System; using System.Media; 

var player = new SoundPlayer(@"C:soundsalert.wav"); try { player.Load(); // 提前加载,避免 Play() 时首次触发异常 player.Play(); } catch (FileNotFoundException) { Console.WriteLine("文件没找到"); } catch (InvalidOperationException ex) when (ex.Message.Contains("format")) { Console.WriteLine("WAV 格式不支持,请检查是否为 PCM 16-bit"); }

WPF 项目播 MP3/OGG?MediaElement 是官方推荐,但得配 XAML

这是微软在 WPF 中主推的控件,底层调用 windows Media Foundation,支持 MP3、WMA、AAC、OGG(需系统编码器),还能绑定进度条、调节音量。但它不是纯代码控件——你必须在 XAML 中声明,再在后台代码里操作。

  • 必须设置 LoadedBehavior="Manual",否则自动播放后无法控制
  • Source 必须是 Uri,且路径要确保编译时被复制到输出目录(属性设为 “复制到输出目录”)
  • Ogg 支持取决于系统是否安装了对应解码器(Windows 10/11 默认不带 Vorbis 解码器,可能无声)
mediaPlayer.Source = new Uri(@"pack://application:,,,/Resources/music.mp3"); mediaPlayer.Play();

要播 MP3/OGG + WinForms + 完全控制?绕不开 NAudio

WinForms 原生不支持 MP3/Ogg,axWindowsMediaPlayer 控件虽能播,但依赖 COM、UI 不可控、已过时;而 NAudio 是事实标准:纯 .net、无 COM、支持解码(MP3 via NAudio.Lame,OGG via NAudio.Vorbis)、可读取帧、调节音量、暂停/恢复、甚至实时处理音频流。

  • 先通过 NuGet 安装:NAudio + NAudio.Vorbis(播 OGG)+ NAudio.Lame(播 MP3)
  • 不要直接 new AudioFileReader 打开 MP3——它不内置 MP3 解码,得用 LameMP3FileReader
  • Ogg 文件要用 VorbisWaveReader 包一层,再传给 WaveOutEvent
  • 务必用 try/catch 包住 newInit 过程,MP3/Ogg 文件损坏或无解码器时会直接抛 InvalidOperationException
using NAudio.Wave; using NAudio.Lame; 

using (var reader = new LameMP3FileReader("song.mp3")) using (var waveOut = new WaveOutEvent()) { waveOut.Init(reader); waveOut.Play(); while (waveOut.PlaybackState == PlaybackState.Playing) { Thread.Sleep(100); } }

临时调试播个本地 WAV?PlaySound P/Invoke 最轻量

如果你只是想快速验证一个 WAV 文件能否响(比如测试声卡、写自动化脚本),用 Windows API 的 PlaySound 是最省事的——不依赖任何 .NET 音频类,一行调用,连对象都不用 new。

  • 必须加 SND_FILENAME 标志,否则它会把字符串当系统声音名(比如 “SystemAsterisk”)
  • SND_ASYNC 让它不阻塞线程;SND_SYNC 则等播完才返回(适合短提示音)
  • 只支持 WAV,且路径不能含中文或特殊字符(Unicode 支持不稳定,建议用英文路径)
[DllImport("winmm.dll")] private static extern bool PlaySound(string szSound, IntPtr hMod, uint flags); 

const uint SND_FILENAME = 0x00020000; const uint SND_ASYNC = 0x0001;

PlaySound(@"C:testbeep.wav", IntPtr.Zero, SND_FILENAME | SND_ASYNC);

真正难的从来不是“怎么播”,而是“播不出时怎么定位”:是路径错了?格式不支持?解码器缺失?还是线程被锁死了?每种方案背后都有对应的失败路径和排查点,选哪个方案,本质是在权衡可控性、兼容性和维护成本。

text=ZqhQzanResources