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

初始化音频系统

初始化音频系统

声音播放不能只调用一次播放函数,还要正确完成设备创建、回调供数、暂停与释放。本课使用 SDL2 打开默认音频设备,生成两秒正弦测试音,并建立可复用的音频系统生命周期。

学习目标

  • 理解音频设备、采样格式、回调缓冲区之间的关系
  • 能初始化 SDL2 音频子系统并播放连续测试音
  • 能在失败或退出路径中按顺序关闭设备并释放资源

建立音频生命周期

音频系统应由明确的拥有者统一管理:启动时初始化音频后端并打开设备,运行时持续向设备缓冲区提供采样,暂停时停止消费数据,退出时先关闭设备再释放后端。若对象销毁后回调仍在执行,回调访问的状态就会变成悬空内存。

音频系统初始化与关闭流程

SDL2 的音频回调由音频线程调用。主线程负责设备生命周期,回调只生成或拷贝采样数据,不应执行文件读取、日志刷盘或复杂锁操作,否则容易造成爆音和卡顿。

用 SDL2 打开设备并播放测试音

项目需要先安装 SDL2 开发库。下面的 CMakeLists.txt 会查找 SDL2,并把示例链接到音频后端;配置成功后,构建系统应能找到 SDL2::SDL2 目标。

cmake
cmake_minimum_required(VERSION 3.16)
project(audio_init LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(SDL2 REQUIRED)

add_executable(audio_init main.cpp)
target_link_libraries(audio_init PRIVATE SDL2::SDL2)

将下面代码保存为 main.cpp。示例请求 48 kHz、单声道、32 位浮点格式,并在回调中生成 440 Hz 正弦波。设备实际采样率可能由系统调整,因此相位步长使用协商后的 obtained.freq 计算。

cpp
#define SDL_MAIN_HANDLED
#include <SDL.h>

#include <cmath>
#include <iostream>

struct ToneState {
    double phase = 0.0;
    int sampleRate = 48000;
};

void audioCallback(void* userData, Uint8* stream, int length) {
    auto* state = static_cast<ToneState*>(userData);
    auto* samples = reinterpret_cast<float*>(stream);
    const int sampleCount = length / static_cast<int>(sizeof(float));
    constexpr double pi = 3.14159265358979323846;
    const double phaseStep = 2.0 * pi * 440.0 / state->sampleRate;

    // 回调必须填满整个缓冲区,否则未写入区域可能产生噪声。
    for (int i = 0; i < sampleCount; ++i) {
        samples[i] = static_cast<float>(0.15 * std::sin(state->phase));
        state->phase += phaseStep;
        if (state->phase >= 2.0 * pi) {
            state->phase -= 2.0 * pi;
        }
    }
}

int main() {
    SDL_SetMainReady();
    if (SDL_Init(SDL_INIT_AUDIO) != 0) {
        std::cerr << "初始化失败: " << SDL_GetError() << "\n";
        return 1;
    }

    ToneState state;
    SDL_AudioSpec wanted{};
    wanted.freq = 48000;
    wanted.format = AUDIO_F32SYS;
    wanted.channels = 1;
    wanted.samples = 1024;
    wanted.callback = audioCallback;
    wanted.userdata = &state;

    SDL_AudioSpec obtained{};
    const SDL_AudioDeviceID device = SDL_OpenAudioDevice(
        nullptr,
        0,
        &wanted,
        &obtained,
        SDL_AUDIO_ALLOW_FREQUENCY_CHANGE
    );

    if (device == 0) {
        std::cerr << "打开设备失败: " << SDL_GetError() << "\n";
        SDL_Quit();
        return 1;
    }

    state.sampleRate = obtained.freq;
    std::cout << "音频设备已打开: " << obtained.freq
              << " Hz, " << static_cast<int>(obtained.channels)
              << " channel(s)\n";

    // 新设备默认暂停,显式启动后回调才会持续供数。
    SDL_PauseAudioDevice(device, 0);
    std::cout << "播放测试音 2 秒\n";
    SDL_Delay(2000);

    SDL_PauseAudioDevice(device, 1);
    SDL_CloseAudioDevice(device);
    SDL_Quit();
    std::cout << "音频系统已关闭\n";
}

预期输出:

text
音频设备已打开: <FREQUENCY> Hz, 1 channel(s)
播放测试音 2 秒
音频系统已关闭

<FREQUENCY> 通常为 48000,但实际值取决于系统音频设备。运行时应能听到音量较低的连续测试音,约两秒后自动停止。

验证与失败处理

若程序打印“打开设备失败”,先确认系统存在可用输出设备,再检查 SDL2 运行库是否与程序架构一致。程序正常输出但没有声音时,应检查系统静音、默认输出设备、远程桌面音频转发和应用音量混音器。

关闭流程必须覆盖正常退出与错误退出。设备打开成功后,先暂停或锁住音频线程,再释放回调使用的缓冲区和状态;最后关闭设备并退出 SDL。真实引擎通常会把这些步骤封装到 AudioSystem::initialize()、update() 和 shutdown() 中,并保证 shutdown() 可重复调用。

本课总结

  • 音频系统的核心不是单次播放,而是设备、回调状态与关闭顺序的完整生命周期
  • 回调应快速、无阻塞,并根据设备协商后的格式持续填满缓冲区
  • 退出时先停止回调和关闭设备,再销毁共享状态,才能避免悬空访问

下一课预告

下一课将加载音频文件并管理声音资源,区分短音效与流式背景音乐的播放策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

初始化音频系统

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

登录哪都通