跳到主要内容

Dream Audio Analyzer

前言

本文以 Dream Audio Analyzer 插件为例,演示从安装到界面展示的完整流程。
开始前,先了解插件支持的三种分析模式:

  • LKFS (5.7+):音频响度国际标准单位,用于精确衡量整体响度。
  • ConstantQ:更贴近人耳听觉特性的时频分析方式,频率分辨率更均衡。
  • Loudness:计算并监控感知响度(Perceived Loudness),常用于响度标准化、混音匹配等场景。

对应设置类如下:

分析模式设置类
ConstantQConstantQSettings
LKFSLKFSSettings
LoudnessLoudnessSettings

安装

  1. 下载插件并解压到项目 Plugins 目录(FAB 下载方式可忽略)。
  2. 在编辑器中打开工程。
  3. 打开“插件(Plugins)”窗口:
  4. 勾选并启用 Dream Audio Analyzer 插件:
  5. 按提示重启编辑器,确保插件模块正确加载。

使用步骤

添加 DreamAudio 分析组件

  1. 在蓝图中点击 Add
  2. 选择需要的分析组件实现:

添加对应设置

  1. 选中组件。
  2. 在属性面板中选择对应的分析器设置:

配置组件

  1. 选择要分析的 Audio Bus,也可以使用自己的音频总线。
  2. 若使用插件内置总线,选择 AB_DreamAudioListen_Channel_A

Analysis Audio Bus 是组件实际执行分析的总线。只要该总线上有音频输入,组件就会持续输出分析结果,与具体音频资产类型无关。

启用 Enable Create Analysis Texture 后,插件会按 Audio Bus 通道数生成可供材质采样的纹理。频谱宽度与范围由分析设置决定。

获取分析结果

所有分析组件都提供回调委托 OnAnalysisResult
该回调返回 FDreamAudioAnalyzerResult 结构体,包含当前组件类型支持的分析数据。 ConstantQ分析会有一个OnAnalysisTextureLoaded的回调,返回了几张按音频通道创建的动态纹理,之后可以在材质中对这个纹理进行采样,做音频可视化。


创建 UMG 界面

按下列截图完成 UI 搭建即可:


修改音频资产

为确保分析组件能收到音频输入,需要在音频资产中指定输出的 Audio Bus。
本教程提供编辑器脚本 ApplyListenAudioBus,可将内置总线 AB_DreamAudioListen_Channel_A 批量应用到选中的音频资产。

脚本运行后,相关音频资产会自动添加对应 Audio Bus:

你也可以手动添加或使用自己的总线。


预览

完成上述配置后运行游戏,即可在屏幕中央看到实时音频分析 UI。下图为 ConstantQ 频谱效果:


其他资源

  • 视频教程(待补充):Bilibili
  • 视频教程(待补充):YouTube

Audio Visual Materials : GITHUB LINK


教程更新日期:2026-03-03
插件版本:1.0.0