游戏客户端架构 / 系统课时

播放背景音乐

播放背景音乐

本课将用 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。

cpp
#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;
}

预期输出

text
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,并让界面事件与游戏逻辑保持清晰边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

播放背景音乐

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通