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

从零拼出可扩展音频系统

从零拼出可扩展音频系统

一套能长期维护的游戏音频系统,不是把所有播放调用堆进一个管理器,而是把“业务发起请求、系统选择总线、后端负责真正播放、句柄负责控制实例”分开。本篇用一个最小可运行骨架把角色音效、UI、音乐、空间声和混音控制串起来,并保留后续接入具体引擎的扩展点。

学习目标

  • 划分业务层、音频系统层、混音总线和播放后端的职责
  • 用统一播放请求同时覆盖 UI、音乐、普通音效和空间音效
  • 通过播放句柄与总线控制,为暂停、停止、限流和引擎接入留下扩展点

先把系统拆成可替换的几层

业务代码不应该直接操作底层播放器。角色、UI 和关卡系统只描述“我要播放什么”;音频系统负责把请求路由到 Music、Sfx、Ui 等总线,并决定是否带空间信息;后端再把这些抽象请求转换成具体引擎 API。

可扩展游戏音频系统分层

这个分层的关键不是类的数量,而是依赖方向:业务层依赖稳定抽象,具体引擎只存在于后端实现中。以后从一个引擎切换到另一个引擎,或增加对象池、语音限流、异步加载时,不需要修改每一个角色和 UI 脚本。

用统一请求描述所有播放需求

下面的 C# 程序定义了四条总线、统一的 AudioRequest、可控制的 AudioHandle,以及一个控制台后端。控制台后端不会真的发声,但程序本身可以运行,并完整演示路由、空间参数、句柄停止和总线音量控制。

csharp
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);
    }
}

预期输出:

text
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”。

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

目录与阅读设置

阅读设置

17

记录一个想法

从零拼出可扩展音频系统

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

登录哪都通