游戏客户端架构 / 系统课时
初始化音频系统
初始化音频系统
声音播放不能只调用一次播放函数,还要正确完成设备创建、回调供数、暂停与释放。本课使用 SDL2 打开默认音频设备,生成两秒正弦测试音,并建立可复用的音频系统生命周期。
学习目标
- 理解音频设备、采样格式、回调缓冲区之间的关系
- 能初始化 SDL2 音频子系统并播放连续测试音
- 能在失败或退出路径中按顺序关闭设备并释放资源
建立音频生命周期
音频系统应由明确的拥有者统一管理:启动时初始化音频后端并打开设备,运行时持续向设备缓冲区提供采样,暂停时停止消费数据,退出时先关闭设备再释放后端。若对象销毁后回调仍在执行,回调访问的状态就会变成悬空内存。

SDL2 的音频回调由音频线程调用。主线程负责设备生命周期,回调只生成或拷贝采样数据,不应执行文件读取、日志刷盘或复杂锁操作,否则容易造成爆音和卡顿。
用 SDL2 打开设备并播放测试音
项目需要先安装 SDL2 开发库。下面的 CMakeLists.txt 会查找 SDL2,并把示例链接到音频后端;配置成功后,构建系统应能找到 SDL2::SDL2 目标。
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 计算。
#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";
}预期输出:
音频设备已打开: <FREQUENCY> Hz, 1 channel(s)
播放测试音 2 秒
音频系统已关闭<FREQUENCY> 通常为 48000,但实际值取决于系统音频设备。运行时应能听到音量较低的连续测试音,约两秒后自动停止。
验证与失败处理
若程序打印“打开设备失败”,先确认系统存在可用输出设备,再检查 SDL2 运行库是否与程序架构一致。程序正常输出但没有声音时,应检查系统静音、默认输出设备、远程桌面音频转发和应用音量混音器。
关闭流程必须覆盖正常退出与错误退出。设备打开成功后,先暂停或锁住音频线程,再释放回调使用的缓冲区和状态;最后关闭设备并退出 SDL。真实引擎通常会把这些步骤封装到 AudioSystem::initialize()、update() 和 shutdown() 中,并保证 shutdown() 可重复调用。
本课总结
- 音频系统的核心不是单次播放,而是设备、回调状态与关闭顺序的完整生命周期
- 回调应快速、无阻塞,并根据设备协商后的格式持续填满缓冲区
- 退出时先停止回调和关闭设备,再销毁共享状态,才能避免悬空访问
下一课预告
下一课将加载音频文件并管理声音资源,区分短音效与流式背景音乐的播放策略。