c# 如何播放音频文件

来源:这里教程网 时间:2026-02-21 17:36:30 作者:

C# 播放音频文件没有“唯一正确答案”,关键看你要播什么格式、跑在什么平台、是否需要控制(暂停/进度/音量)、以及能否接受第三方依赖。直接结论:

System.Media.SoundPlayer
只能播
.wav
MediaPlayer
(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;
<p>var player = new SoundPlayer(@"C:\sounds\alert.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 解码器,可能无声)
<MediaElement x:Name="mediaPlayer" 
              LoadedBehavior="Manual" 
              UnloadedBehavior="Stop" />
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
包住
new
Init
过程,MP3/Ogg 文件损坏或无解码器时会直接抛
InvalidOperationException
using NAudio.Wave;
using NAudio.Lame;
<p>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);
<p>const uint SND_FILENAME = 0x00020000;
const uint SND_ASYNC = 0x0001;</p><p>PlaySound(@"C:\test\beep.wav", IntPtr.Zero, SND_FILENAME | SND_ASYNC);

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

相关推荐

热文推荐