C#如何播放音频文件_C# SoundPlayer与NAudio库播放WAV【实用】-C#.Net教程-PHP中文网

soundplayer仅支持pcm编码、16-bit、≤48khz的wav，超限则静音或抛invalidoperationexception；naudio通过wavefilereader自动适配多种wav子类型，需用waveoutevent避免跨线程异常并及时dispose释放资源。

c#如何播放音频文件_c# soundplayer与naudio库播放wav【实用】

SoundPlayer 和 NAudio 是 C# 中处理 WAV 文件最常用的两种方式，但它们定位完全不同：前者是 .NET 内置、轻量、仅支持 WAV 的播放器；后者是功能完整、可录制/编辑/多格式支持的第三方库。选错会导致运行时崩溃、静音、或根本播不出声。

为什么 SoundPlayer 播放 WAV 会静音或报错

常见现象是调用 Play() 后没声音，或抛出 InvalidOperationException：“无法播放音频流”。这不是代码写错了，而是 SoundPlayer 对 WAV 文件有硬性限制：

只接受 PCM 编码、16-bit、单声道或立体声、采样率 ≤ 48 kHz 的 WAV —— 任何带 ADPCM、IEEE float、24-bit、或 96 kHz 的 WAV 都会被静默忽略
不支持从网络流或内存流直接播放（除非先写入临时文件）
在 Windows Server 或无音频设备的环境（如 CI 服务器）中会直接失败
PlaySync() 会阻塞主线程，UI 界面卡死；Play() 异步但无法控制暂停/停止

如果你只是想快速播个提示音（比如 SystemSounds.Beep.Play() 那种），SoundPlayer 够用；但凡涉及用户选择的 WAV 文件，别默认信任它能播。

NAudio 播放 WAV 的最小可行写法

用 NAudio 播放 WAV 不需要复杂配置，核心就三行：打开文件 → 创建输出设备 → 播放。但必须注意资源释放和线程安全：

必须用 WaveOutEvent（不是 WaveOut），否则在 WinForms/WPF 中容易引发跨线程异常
WaveFileReader 会自动识别编码格式，支持 8/16/24/32-bit PCM、float、ADPCM 等所有常见 WAV 子类型
播放结束后不调用 Dispose() 或 Stop()，可能残留音频句柄导致后续播放失败
不要在 UI 线程直接 new WaveOutEvent 并 Init()，建议封装成独立方法并 await 或用 BackgroundWorker

简短示例：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

using NAudio.Wave;
// ...
using (var reader = new WaveFileReader("alert.wav"))
using (var player = new WaveOutEvent())
{
    player.Init(reader);
    player.Play();
    while (player.PlaybackState == PlaybackState.Playing)
        Thread.Sleep(100);
}

PlaySound API 调用 winmm.dll 的实际坑点

很多老项目用 [DllImport("winmm.dll")] 调 PlaySound()，看似简单，但实际部署时问题最多：

PlaySoundFlags.SND_FILENAME 必须配合 PlaySoundFlags.SND_ASYNC 或 SND_SYNC，漏掉任一 flag 会导致静音（尤其 SND_FILENAME 不设就是读资源 ID）
路径含中文或空格时，CharSet = CharSet.Unicode 必须显式指定，否则传参乱码，函数返回 false
Windows 10/11 默认禁用 Legacy Audio APIs，某些企业版或精简系统里 winmm.dll 根本不加载，GetLastError() 返回 126（找不到模块）
无法获取播放进度、无法暂停、无法监听完成事件 —— 它就是个“发完就不管”的黑盒

除非你明确要兼容 Windows XP 或嵌入式 CE 系统，否则不建议新项目再走这条路。

WAV 文件播放前必须做的校验

用户选的 WAV 文件五花八门，不能全靠播放器扛。建议在调用任何播放逻辑前加一层快速检查：

用 Path.GetExtension(path).Equals(".wav", StringComparison.OrdinalIgnoreCase) 过滤扩展名（注意大小写）
用 new FileInfo(path).Length > 44 排除空文件（WAV 头至少 44 字节）
若用 NAudio，可提前尝试 new WaveFileReader(path) 并 catch NotSupportedException 或 InvalidDataException，再给用户友好提示（例如“该 WAV 使用不支持的压缩格式”）
避免用 SoundPlayer 加载前不做判断 —— 它不会抛异常，只会静默失败，用户以为程序坏了