游戏客户端架构 / 系统课时
从零拼出可扩展音频系统
从零拼出可扩展音频系统
一套能长期维护的游戏音频系统,不是把所有播放调用堆进一个管理器,而是把“业务发起请求、系统选择总线、后端负责真正播放、句柄负责控制实例”分开。本篇用一个最小可运行骨架把角色音效、UI、音乐、空间声和混音控制串起来,并保留后续接入具体引擎的扩展点。
学习目标
- 划分业务层、音频系统层、混音总线和播放后端的职责
- 用统一播放请求同时覆盖 UI、音乐、普通音效和空间音效
- 通过播放句柄与总线控制,为暂停、停止、限流和引擎接入留下扩展点
先把系统拆成可替换的几层
业务代码不应该直接操作底层播放器。角色、UI 和关卡系统只描述“我要播放什么”;音频系统负责把请求路由到 Music、Sfx、Ui 等总线,并决定是否带空间信息;后端再把这些抽象请求转换成具体引擎 API。

这个分层的关键不是类的数量,而是依赖方向:业务层依赖稳定抽象,具体引擎只存在于后端实现中。以后从一个引擎切换到另一个引擎,或增加对象池、语音限流、异步加载时,不需要修改每一个角色和 UI 脚本。
用统一请求描述所有播放需求
下面的 C# 程序定义了四条总线、统一的 AudioRequest、可控制的 AudioHandle,以及一个控制台后端。控制台后端不会真的发声,但程序本身可以运行,并完整演示路由、空间参数、句柄停止和总线音量控制。
using System;
using System.Collections.Generic;
public enum AudioBus
{
Master,
Music,
Sfx,
Ui
}
public readonly record struct Vec3(float X, float Y, float Z);
public sealed record AudioRequest(
string ResourceId,
AudioBus Bus,
bool Spatial,
Vec3 Position);
public sealed class AudioHandle
{
public string Id { get; }
public bool IsPlaying { get; private set; } = true;
public AudioHandle(string id)
{
Id = id;
}
public void MarkStopped()
{
IsPlaying = false;
}
}
public interface IAudioBackend
{
AudioHandle Play(AudioRequest request);
void Stop(AudioHandle handle);
void SetBusVolume(AudioBus bus, float volume);
}
public sealed class ConsoleAudioBackend : IAudioBackend
{
private int _nextHandle = 1;
public AudioHandle Play(AudioRequest request)
{
var handle = new AudioHandle($"h-{_nextHandle++}");
var spatial = request.Spatial
? $" position=({request.Position.X},{request.Position.Y},{request.Position.Z})"
: string.Empty;
Console.WriteLine(
$"PLAY {handle.Id} bus={request.Bus} resource={request.ResourceId}{spatial}");
return handle;
}
public void Stop(AudioHandle handle)
{
handle.MarkStopped();
Console.WriteLine($"STOP {handle.Id}");
}
public void SetBusVolume(AudioBus bus, float volume)
{
var clamped = Math.Clamp(volume, 0f, 1f);
Console.WriteLine($"VOLUME bus={bus} value={clamped:0.00}");
}
}
public sealed class AudioSystem
{
private readonly IAudioBackend _backend;
private readonly Dictionary<string, AudioHandle> _active = new();
public AudioSystem(IAudioBackend backend)
{
_backend = backend;
}
public AudioHandle Play(AudioRequest request)
{
var handle = _backend.Play(request);
_active[handle.Id] = handle;
return handle;
}
public void Stop(AudioHandle handle)
{
if (!_active.Remove(handle.Id))
{
return;
}
_backend.Stop(handle);
}
public void SetBusVolume(AudioBus bus, float volume)
{
_backend.SetBusVolume(bus, volume);
}
}
public static class Program
{
public static void Main()
{
var audio = new AudioSystem(new ConsoleAudioBackend());
var uiClick = audio.Play(new AudioRequest(
"ui/button-click", AudioBus.Ui, false, default));
var footstep = audio.Play(new AudioRequest(
"sfx/hero/footstep-01", AudioBus.Sfx, true, new Vec3(3f, 0f, 5f)));
var music = audio.Play(new AudioRequest(
"music/battle-theme", AudioBus.Music, false, default));
audio.SetBusVolume(AudioBus.Music, 0.6f);
audio.Stop(footstep);
}
}预期输出:
PLAY h-1 bus=Ui resource=ui/button-click
PLAY h-2 bus=Sfx resource=sfx/hero/footstep-01 position=(3,0,5)
PLAY h-3 bus=Music resource=music/battle-theme
VOLUME bus=Music value=0.60
STOP h-2真实项目接入 Unity、Unreal 或自研引擎时,只需让后端实现把 Play、Stop 和总线音量转换成该引擎真实存在的 API;上层 AudioSystem 和业务请求模型仍可保持不变。
把不同声音的规则放在正确位置
角色脚步、武器、受击等高频音效适合走 Sfx 总线,并在系统层增加并发上限或优先级。UI 声音通常不需要空间化,应走 Ui 总线,避免被世界空间衰减。背景音乐走 Music 总线,常见扩展是淡入淡出、曲目切换和场景状态驱动。
空间声不是单独的一套系统,而是播放请求的一个能力维度。请求里携带位置后,由后端决定怎样计算距离衰减、声像或 3D 参数;业务层不应该直接操作底层声源对象。
混音控制则应作用在总线上,而不是遍历所有播放实例逐个改音量。这样设置页中的“音乐音量”“音效音量”才能稳定影响当前与后续播放。
用验收项判断系统是否真的可扩展
最小系统完成后,不要只验证“能出声”。至少要确认同一个资源可以同时生成多个独立句柄;停止一个句柄不会误伤其他实例;UI、音乐和音效能被不同总线独立控制;空间声请求能携带位置;替换后端实现时业务调用无需修改。
只要业务请求、系统调度、混音控制和具体播放后端仍保持清晰边界,这个最小骨架就能自然长成工程化音频系统,而不会退化成一个越来越难维护的“万能 AudioManager”。