游戏客户端架构 / 系统课时
播放背景音乐
播放背景音乐
本课将用 SDL2_mixer 建立背景音乐控制器,完成曲目切换、暂停、恢复和淡入淡出。最终程序会把音乐行为收敛为清晰的状态变化,避免重复加载、突然截断或暂停后无法继续播放的问题。
学习目标
- 使用
Mix_Music加载并循环播放背景音乐 - 实现切换、暂停、恢复和渐变停止
- 根据播放状态选择正确的控制 API
建立背景音乐状态模型
背景音乐与短音效不同:它通常以流式方式解码,并由 SDL2_mixer 的专用音乐通道播放。同一时刻只维护一条主音乐更容易控制,因此切换曲目时应先让旧曲目淡出,再启动新曲目的淡入。

Mix_PauseMusic 只冻结当前位置,不会释放曲目;Mix_ResumeMusic 会从原位置继续。Mix_HaltMusic 会立即停止,而 Mix_FadeOutMusic 会在指定毫秒数内逐渐降低音量,更适合场景切换。
实现音乐切换与控制
下面的完整示例加载两首 OGG 音乐,并通过控制台命令操作。运行前准备 assets/audio/theme_a.ogg 与 assets/audio/theme_b.ogg,项目需链接 SDL2 和 SDL2_mixer。
#include <SDL2/SDL.h>
#include <SDL2/SDL_mixer.h>
#include <iostream>
bool fadeOutAndWait(int milliseconds) {
if (!Mix_PlayingMusic()) {
return true;
}
if (Mix_PausedMusic()) {
Mix_ResumeMusic();
}
if (Mix_FadeOutMusic(milliseconds) == 0) {
return false;
}
// 等待淡出完成,避免旧曲目与新曲目长时间重叠。
while (Mix_FadingMusic() == MIX_FADING_OUT) {
SDL_Delay(10);
}
return true;
}
bool playWithFadeIn(Mix_Music* music, const char* name) {
if (!fadeOutAndWait(500)) {
std::cerr << "Fade out failed: " << Mix_GetError() << '\n';
return false;
}
if (Mix_FadeInMusic(music, -1, 800) == -1) {
std::cerr << "Play failed: " << Mix_GetError() << '\n';
return false;
}
std::cout << "playing: " << name << '\n';
return true;
}
int main() {
if (SDL_Init(SDL_INIT_AUDIO) != 0) {
std::cerr << "SDL init failed: " << SDL_GetError() << '\n';
return 1;
}
const int requiredFlags = MIX_INIT_OGG;
if ((Mix_Init(requiredFlags) & requiredFlags) != requiredFlags) {
std::cerr << "OGG support unavailable: " << Mix_GetError() << '\n';
SDL_Quit();
return 1;
}
if (Mix_OpenAudio(44100, MIX_DEFAULT_FORMAT, 2, 2048) < 0) {
std::cerr << "Open audio failed: " << Mix_GetError() << '\n';
Mix_Quit();
SDL_Quit();
return 1;
}
Mix_Music* themeA = Mix_LoadMUS("assets/audio/theme_a.ogg");
Mix_Music* themeB = Mix_LoadMUS("assets/audio/theme_b.ogg");
if (themeA == nullptr || themeB == nullptr) {
std::cerr << "Load music failed: " << Mix_GetError() << '\n';
if (themeA != nullptr) {
Mix_FreeMusic(themeA);
}
if (themeB != nullptr) {
Mix_FreeMusic(themeB);
}
Mix_CloseAudio();
Mix_Quit();
SDL_Quit();
return 1;
}
std::cout << "commands: 1, 2, p, r, f, q\n";
char command = '\0';
while (std::cin >> command && command != 'q') {
if (command == '1') {
playWithFadeIn(themeA, "theme_a");
} else if (command == '2') {
playWithFadeIn(themeB, "theme_b");
} else if (command == 'p' && Mix_PlayingMusic()) {
Mix_PauseMusic();
std::cout << "paused\n";
} else if (command == 'r' && Mix_PausedMusic()) {
Mix_ResumeMusic();
std::cout << "resumed\n";
} else if (command == 'f') {
fadeOutAndWait(1000);
std::cout << "faded out\n";
}
}
Mix_HaltMusic();
Mix_FreeMusic(themeA);
Mix_FreeMusic(themeB);
Mix_CloseAudio();
Mix_Quit();
SDL_Quit();
std::cout << "quit\n";
return 0;
}预期输出
commands: 1, 2, p, r, f, q
playing: theme_a
paused
resumed
playing: theme_b
faded out
quit以上输出对应依次输入 1、p、r、2、f、q。淡入、淡出时长分别为 800、500 或 1000 毫秒,实际听感还会受音频开头是否留白影响。
选择正确的控制方式
| 需求 | API | 行为 |
|---|---|---|
| 从头循环播放 | Mix_FadeInMusic(music, -1, ms) |
-1 表示无限循环 |
| 临时暂停 | Mix_PauseMusic() |
保留当前播放位置 |
| 继续播放 | Mix_ResumeMusic() |
从暂停位置恢复 |
| 平滑停止 | Mix_FadeOutMusic(ms) |
完成后停止当前音乐 |
| 立即停止 | Mix_HaltMusic() |
不保留进度,也没有渐变 |
不要把暂停实现为停止后重新播放,否则恢复时会从头开始。曲目切换也不应只替换资源指针;必须先处理正在播放的旧曲目,再启动新曲目,并确保旧资源在停止后才释放。
验证切换与边界行为
运行程序后先播放 theme_a,确认音乐会持续循环;暂停数秒再恢复,检查是否从原位置继续。随后切换到 theme_b,应先听到旧曲目淡出,再听到新曲目淡入,过程中不应出现明显爆音。
还要验证三种边界:未播放时执行暂停不会崩溃,重复恢复不会重新开始曲目,退出前会立即停止音乐并释放两个资源。若加载失败,应优先检查工作目录、文件名大小写和 SDL2_mixer 是否启用了 OGG 支持。
本课总结
- 背景音乐应使用专用的
Mix_Music播放路径,并保持单一主曲目 - 暂停与停止语义不同,恢复播放时不能重新加载或从头启动
- 曲目切换通过先淡出、再淡入获得稳定且自然的听觉过渡
下一课预告
下一课将进入界面系统,把按钮、文本和布局组织成可交互的 UI,并让界面事件与游戏逻辑保持清晰边界。