当前位置：首页 > news >正文

WPF为启动界面（Splash Screen）添加背景音乐

news 2025/7/20 6:20:16

1. 添加音频文件到项目

将音频文件（如.mp3/.wav）放入项目文件夹（如Resources）
在解决方案资源管理器中右键文件 → 属性：
- 生成操作：选择Resource（嵌入资源）或Content（内容文件）
- 复制到输出目录：选择始终复制

2. 创建启动界面窗口

新建一个WPF窗口作为启动界面（如SplashScreenWindow.xaml）：

<Window x:Class="YourNamespace.SplashScreenWindow"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"WindowStyle="None" AllowsTransparency="True" Background="Transparent" WindowStartupLocation="CenterScreen"><Grid><!-- 添加你的启动界面内容（如图片、进度条等） --><Image Source="splash_image.png"/></Grid>
</Window>

3. 在启动界面后台代码中播放音乐

修改SplashScreenWindow.xaml.cs：

using System.Windows;
using System.Windows.Media;public partial class SplashScreenWindow : Window
{private MediaPlayer _mediaPlayer;public SplashScreenWindow(){InitializeComponent();Loaded += OnLoaded;}private void OnLoaded(object sender, RoutedEventArgs e){// 初始化媒体播放器_mediaPlayer = new MediaPlayer();_mediaPlayer.MediaEnded += (s, args) => {_mediaPlayer.Position = TimeSpan.Zero; // 循环播放_mediaPlayer.Play();};try{// 加载音频资源（根据文件属性选择路径格式）Uri audioUri = new Uri("pack://application:,,,/Resources/background_music.mp3");_mediaPlayer.Open(audioUri);_mediaPlayer.Play();}catch (Exception ex){MessageBox.Show($"播放音乐失败: {ex.Message}");}}// 窗口关闭时停止音乐protected override void OnClosed(EventArgs e){_mediaPlayer?.Stop();_mediaPlayer?.Close();base.OnClosed(e);}
}

4. 修改App.xaml.cs启动逻辑

在App.xaml.cs中显示启动界面，并在主窗口显示后关闭它：

protected override void OnStartup(StartupEventArgs e)
{// 创建并显示启动窗口var splashScreen = new SplashScreenWindow();splashScreen.Show();// 模拟初始化耗时操作System.Threading.Thread.Sleep(3000); // 实际中替换为真实初始化代码// 创建主窗口var mainWindow = new MainWindow();mainWindow.Show();// 关闭启动窗口splashScreen.Close();base.OnStartup(e);
}

关键点说明

音频文件路径：
- 若文件属性为Resource，使用："pack://application:,,,/YourAssemblyName;component/Resources/background_music.mp3"
- 若为Content，使用："Resources/background_music.mp3"（相对输出目录路径）
媒体播放器控制：
- MediaPlayer.Play()：开始播放
- MediaPlayer.Stop()：停止并重置位置
- MediaPlayer.Close()：释放资源
- 订阅MediaEnded事件实现循环播放
资源释放：
务必在窗口关闭时停止并释放MediaPlayer，避免资源泄漏。

替代方案：使用App.xaml全局播放

如果需要在主窗口继续播放音乐，可将播放器移至App类：

// App.xaml.cs
public partial class App : Application
{private MediaPlayer _mediaPlayer;protected override void OnStartup(StartupEventArgs e){_mediaPlayer = new MediaPlayer();_mediaPlayer.Open(new Uri("pack://application:,,,/Resources/background_music.mp3"));_mediaPlayer.Play();// 显示启动窗口和主窗口（同上）base.OnStartup(e);}// 应用退出时停止音乐protected override void OnExit(ExitEventArgs e){_mediaPlayer?.Stop();_mediaPlayer?.Close();base.OnExit(e);}
}