如何在跨平台Avalonia应用中可靠播放WAV资源？

问题分析 #

你当前用NAudio的WaveOutEvent播放音效，在蓝牙设备上失效的核心原因是：WaveOutEvent基于Windows传统WaveOut API，对现代蓝牙音频设备的格式适配和会话管理支持不足，容易出现采样率不匹配、音频流中断的问题。

方案1：替换NAudio的输出设备为WasapiOut #

WasapiOut基于Windows Core Audio API，对蓝牙音频设备的兼容性更好，只需修改现有代码的输出部分：

修改文件播放代码 #

using NAudio.Wave;
using NAudio.CoreAudioApi;

private void PlayWaveFile(string waveFilePath)
{
    using (var audioFileReader = new AudioFileReader(waveFilePath))
    {
        using (var wasapiOut = new WasapiOut(AudioClientShareMode.Shared, 100))
        {
            wasapiOut.Init(audioFileReader);
            wasapiOut.Play();
            while (wasapiOut.PlaybackState == PlaybackState.Playing)
            {
                Thread.Sleep(10);
            }
        }
    }
}

修改资源播放代码 #

using NAudio.Wave;
using NAudio.CoreAudioApi;
using Avalonia.Platform;

private void PlayWaveResource(string waveResourceName, string assemblyName)
{
    var uri = new Uri($"avares://{assemblyName}/Assets/{waveResourceName}.wav");
    using (var assetStream = AssetLoader.Open(uri))
    using (var memoryStream = new MemoryStream())
    {
        assetStream.CopyTo(memoryStream);
        memoryStream.Seek(0, SeekOrigin.Begin);
        
        using (var waveFileReader = new WaveFileReader(memoryStream))
        using (var wasapiOut = new WasapiOut(AudioClientShareMode.Shared, 100))
        {
            wasapiOut.Init(waveFileReader);
            wasapiOut.Play();
            while (wasapiOut.PlaybackState == PlaybackState.Playing)
            {
                Thread.Sleep(10);
            }
        }
    }
}

方案2：使用Avalonia内置MediaElement（无额外依赖，全平台支持） #

Avalonia的MediaElement利用各平台原生多媒体框架，无需引入第三方库，对蓝牙设备的支持由系统原生处理，兼容性更强：

步骤1：在Avalonia界面添加MediaElement（可隐藏） #

在你的窗口/UserControl的XAML中添加：

<MediaElement x:Name="SoundPlayer" Visibility="Collapsed" />

步骤2：播放资源音效的代码 #

using Avalonia.Media;
using Avalonia.Platform;

private void PlayWaveResource(string waveResourceName, string assemblyName)
{
    var uri = new Uri($"avares://{assemblyName}/Assets/{waveResourceName}.wav");
    // 将资源流转换为临时文件（MediaElement直接读取资源流可能存在跨平台兼容性问题）
    using (var assetStream = AssetLoader.Open(uri))
    {
        var tempPath = Path.Combine(Path.GetTempPath(), $"{waveResourceName}.wav");
        using (var fileStream = File.Create(tempPath))
        {
            assetStream.CopyTo(fileStream);
        }
        SoundPlayer.Source = new Uri(tempPath);
        SoundPlayer.Play();
        
        // 播放完成后删除临时文件
        SoundPlayer.MediaEnded += (s, e) =>
        {
            if (File.Exists(tempPath))
            {
                try { File.Delete(tempPath); } catch { }
            }
        };
    }
}

方案3：跨平台音频库推荐（无缝部署） #

如果需要更灵活的音效控制（如音量、多音效叠加），推荐使用OpenTK.Audio.OpenAL：

• 纯托管实现，可嵌入程序集，无需用户安装依赖
• 支持所有目标平台（Windows/Linux/Mac/Android/iOS）
• 对蓝牙设备的音频格式适配完善

核心播放代码示例 #

using OpenTK.Audio.OpenAL;

private int _soundBuffer;
private int _soundSource;

// 初始化（建议在程序启动时执行）
private void InitAudio()
{
    AL.CreateContext();
    AL.MakeContextCurrent(AL.Context);
    
    // 加载资源音效到缓冲区
    var uri = new Uri($"avares://YourAssembly/Assets/YourSound.wav");
    using (var assetStream = AssetLoader.Open(uri))
    using (var reader = new BinaryReader(assetStream))
    {
        // 跳过WAV文件头（实际需根据文件格式完整解析）
        reader.ReadBytes(44);
        var audioData = reader.ReadBytes((int)assetStream.Length - 44);
        
        _soundBuffer = AL.GenBuffer();
        AL.BufferData(_soundBuffer, ALFormat.Stereo16, audioData, 44100);
        
        _soundSource = AL.GenSource();
        AL.Source(_soundSource, ALSourcei.Buffer, _soundBuffer);
    }
}

// 播放音效
private void PlaySound()
{
    AL.SourcePlay(_soundSource);
}

// 释放资源（程序退出时执行）
private void CleanupAudio()
{
    AL.DeleteSource(_soundSource);
    AL.DeleteBuffer(_soundBuffer);
    AL.DestroyContext(AL.Context);
}

注意事项 #

• 所有方案均需确保WAV文件格式为44.1kHz 16位立体声，这是蓝牙设备最兼容的格式
• 测试时优先使用方案2（Avalonia原生），无需额外依赖，跨平台一致性最好

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