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();
   }
   

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