WPF 初始界面启动时播放背景音乐

在 WPF 项目中实现启动时播放背景音乐且只播放一次，可以通过以下步骤实现。这里使用 MediaPlayer 类来播放音频，并确保音乐只播放一次：

完整实现方案

1. 添加音频文件到项目

1. 在项目中创建 Assets 或 Media 文件夹
2. 添加音频文件（如 background.mp3）
3. 设置文件属性：
   • 生成操作：Resource
   • 复制到输出目录：不复制

2. 修改 App.xaml.cs

using System.Windows;
using System.Windows.Media;namespace YourNamespace
{public partial class App : Application{// 静态变量确保只播放一次private static bool _isMusicPlayed = false;private static MediaPlayer _mediaPlayer;protected override void OnStartup(StartupEventArgs e){base.OnStartup(e);if (!_isMusicPlayed){PlayBackgroundMusic();_isMusicPlayed = true;}// 创建并显示主窗口var mainWindow = new MainWindow();mainWindow.Show();}private void PlayBackgroundMusic(){try{_mediaPlayer = new MediaPlayer();// 使用pack URI访问资源文件Uri uri = new Uri("pack://application:,,,/Assets/background.mp3", UriKind.Absolute);_mediaPlayer.Open(uri);_mediaPlayer.MediaEnded += (s, e) => CleanupMediaPlayer();_mediaPlayer.Play();}catch (System.IO.IOException ex){// 处理文件加载错误MessageBox.Show($"无法加载背景音乐: {ex.Message}");}}private void CleanupMediaPlayer(){if (_mediaPlayer != null){_mediaPlayer.Stop();_mediaPlayer.Close();_mediaPlayer = null;}}}
}

3. 修改 App.xaml (可选)

<Application x:Class="YourNamespace.App"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"StartupUri="MainWindow.xaml"><!-- 不需要额外资源时可以保持空 -->
</Application>

关键点解释

1. 单次播放保证：

   • 使用静态变量 _isMusicPlayed 确保音乐在整个应用生命周期只播放一次
   • 静态变量在应用重启时会重置，但单次运行中保持不变

2. 资源加载：

   • 使用 pack://application:,,, URI 方案访问嵌入资源
   • 文件路径格式：/程序集名称;component/文件夹/文件名.mp3

3. 资源管理：

   • 在音乐结束后调用 CleanupMediaPlayer() 释放资源
   • 使用 MediaEnded 事件处理播放完成

4. 错误处理：

   • 捕获文件加载异常，避免应用崩溃
   • 提供用户友好的错误提示

进阶优化方案

如果需要更多控制（如音量调节、暂停等），可封装音乐服务：

// BackgroundMusicService.cs
public class BackgroundMusicService : IDisposable
{private static readonly Lazy<BackgroundMusicService> _instance = new Lazy<BackgroundMusicService>(() => new BackgroundMusicService());public static BackgroundMusicService Instance => _instance.Value;private MediaPlayer _player;private bool _isPlaying;private BackgroundMusicService(){_player = new MediaPlayer();_player.MediaEnded += (s, e) => Stop();}public void PlayOnce(){if (_isPlaying) return;try{Uri uri = new Uri("pack://application:,,,/Assets/background.mp3");_player.Open(uri);_player.Volume = 0.5; // 50% 音量_player.Play();_isPlaying = true;}catch (Exception ex){Debug.WriteLine($"背景音乐播放失败: {ex.Message}");}}public void Stop(){if (!_isPlaying) return;_player.Stop();_isPlaying = false;}public void Dispose(){_player?.Close();_player = null;}
}// App.xaml.cs 修改
protected override void OnStartup(StartupEventArgs e)
{BackgroundMusicService.Instance.PlayOnce();// ...
}

常见问题解决

1. 文件找不到错误：

   • 确认文件路径正确
   • 检查文件属性中的生成操作是否为 Resource
   • 尝试使用完整路径：pack://application:,,,/YourAppName;component/Assets/background.mp3

2. 音乐不播放：

   • 检查音频文件格式（WPF 支持 MP3、WAV、WMA）
   • 确保音量未设置为 0
   • 尝试在代码中添加：_mediaPlayer.Play();

3. 多实例问题：

   • 使用静态单例模式确保全局只有一个播放器
   • 在应用退出时释放资源：Application.Current.Exit += (s, e) => CleanupMediaPlayer();

4. 跨窗口控制：

   // 在任何窗口控制音乐
   public partial class SettingsWindow : Window
   {private void MuteButton_Click(object sender, RoutedEventArgs e){BackgroundMusicService.Instance.Stop();}
   }
   

最佳实践建议

1. 使用轻量音频格式：

   • 推荐使用 MP3 或 OGG 格式
   • 避免使用未压缩的 WAV 文件

2. 音量控制：

   // 设置音量（0.0 到 1.0）
   _mediaPlayer.Volume = 0.7; // 淡入效果
   DoubleAnimation fadeIn = new DoubleAnimation(0, 1, TimeSpan.FromSeconds(3));
   _mediaPlayer.BeginAnimation(MediaPlayer.VolumeProperty, fadeIn);
   

3. 资源释放：

   protected override void OnExit(ExitEventArgs e)
   {BackgroundMusicService.Instance.Dispose();base.OnExit(e);
   }
   

4. 用户设置集成：

   // 检查用户设置
   if (Properties.Settings.Default.PlayStartupSound)
   {PlayBackgroundMusic();
   }
   

此方案确保背景音乐在应用启动时自动播放且只播放一次，同时提供了资源管理和错误处理机制。根据需求可选择基础实现或封装服务的高级方案。