1. Epic GamesDeveloper
  3. AudioInsights插件

AudioInsights插件

AudioInsights插件概述。

概述

AudioInsights是一个引擎插件，提供一套工具来分析、调试和监控虚幻引擎中音频的运行时状态。 通过多个选项卡窗口，AudioInsights可以在实时游戏期间为声源（Sources）、音频总线（Audio Buses）、子混音（Submixes）等提供当前音调、音量和其他参数值的可视化显示和数值信息。 它可以为PIE会话以及独立游戏提供信息。

Audio-insights-main-dashboard。

快速入门

AudioInsights默认不启用。 要启用它，在虚幻编辑器中选择编辑 > 插件（Edit > Plugins）并启用AudioInsights插件。 你需要点击立即重启（Restart Now）以加载插件。

Audio-insights-in-the-plugin-menu。

为项目启用后，你可以从编辑器窗口的工具（Tools）菜单中打开AudioInsights窗口，选择Audio Insights：

Select-audio-insights-from-the-tools-menu。

开始PIE会话将开始用音频引擎的数据填充AudioInsights窗口。 AudioInsights需要使用UnrealInsights进行跟踪记录，打开AudioInsights窗口将在你进入PIE会话时自动开始记录跟踪。 AudioInsights是一个选项卡窗口，可以停靠在编辑器中的任何位置以随时使用。

在独立游戏中使用AudioInsights需要使用UnrealInsights。 从编辑器窗口右下角的跟踪（Trace）菜单中，选择Unreal Insights（会话浏览器），然后在UnrealInsights启动后退出编辑器。

Unreal-insights-from-the-Trace-menu。

或者，你可以使用命令行运行UnrealInsights：

/Engine/Binaries/Win64/UnrealInsights.exe -DisableFramerateThrottle

额外的标记将使UnrealInsights即使在非焦点状态下也能以60fps运行。 使用-Messaging标记启动独立游戏，并从UnrealInsights使用连接（Connection）选项卡连接到它，确保在初始通道（Initial channels）字段中指示cpu, audio, and audiomixer（逗号后无空格），然后点击连接（Connect）。

Unreal-insights-frontend。

这将连接到当前运行的游戏。 在跟踪存储（Trace Store）选项卡中，找到标记为LIVE的跟踪并双击以显示跟踪会话窗口。 在菜单（Menu）中，选择Audio Insights选项。

Menu-select-audio-insights。

这将显示一个AudioInsights窗口，其工作方式类似于上面连接到PIE的窗口。 AudioInsights的独立实例没有与PIE工作相同的消息传递，只有声音（Sounds）、声源（Sources）和虚拟循环（Virtual Loops）选项卡可用。

音频数据详情选项卡

可见选项卡使用Audio Insights选项卡中的视图（View）菜单配置：

The-tabs-available-on-the-view-menu。

详细选项卡可以重新定位到Audio Insights选项卡内的任何位置，或作为自由浮动窗口拖拽出来。 选择重置布局（Reset Layout）将修复任何由此产生的不受控制的选项卡混乱。

顶层控制：

  • 仅在PIE期间跟踪音频信号：AudioInsights使用UnrealInsights跟踪功能，这可能会生成大量数据。 如果你只为AudioInsights启用跟踪，启用此复选框将减少在你使用AudioInsights监控和调试会话时存储的数据量

  • 世界过滤器（World Filter）：此下拉菜单为你提供从当前运行的世界（包括编辑器）中选择音频数据的选项

日志选项卡

日志（Log）选项卡是另一种便利的方式，可以在你可能查看的任何相关音频信息旁边过滤和观察虚幻编辑器日志。 此数据默认显示所有音频特定的日志类别，但你可以更改过滤器以包含或排除任何其他日志类别和详细程度。

Log-tab-image。

声音选项卡

声音（Sounds）选项卡显示所有当前播放的声音资产，按类别列出，每个都有运行时数据的文本显示。 它使你能够与正在播放的声音交互，以静音或独奏混音中的元素。 用于识别声音的名称是Uasset名称而不是运行时实例名称。

Full-screen-view-of-the-Sounds-tab。

声音类别

  • MetaSound：MetaSound源资产

  • Sound Cue：Sound Cue和任何子声波（Sound Waves）

  • 程序化源（Procedural Source）：任何在代码中继承自USoundWaveProcedural的混合器输入对象

  • Sound Wave：简单的波形资产

  • Sound Cue模板：从模板在运行时构建的Sound Cue

  • 其他：音频源总线

数据

  • 静音（Muted）：显示此声音实例是否被静音

  • 独奏（Soloed）：显示此声音实例是否被独奏

  • 名称（Name）：声音的UAsset名称，而不是运行时实例名称

  • 优先级（Priority）：为并发设置，正浮点值，数字越高表示优先级越高

  • 距离（Distance）：从地图单位中声音渲染器的正距离

  • Amp（峰值）：跟踪声音幅度的包络跟随器值，从0.0到1.0的浮点值，表示最大输出幅度

  • 音量（Volume）：此声音实例的所有音量值和调制器的总和，不包括距离衰减，作为线性幅度倍增器的正浮点值

  • 音调（Pitch）：此声音实例的所有音调值和调制器的总和，作为线性播放速率倍增器的正浮点值

  • 聚合（Aggregation）：在包含多个子声波的Sound Cue等分层对象中，Sound Cue音量和音调将显示顶层值，但声波将显示Sound Cue顶层和Sound Cue内该声波发生的任何其他调制的聚合值

显示选项

  • 显示已停止（Show Stopped）：选中时，这将使最近停止的声音继续在列表中显示几秒钟的灰显状态，使观察短声音变得更容易

    Image-showing-grayed-out-option-for-show-stopped。

  • 过滤类别（Filter Categories）：在选项卡标题中显示类别按钮，允许快速过滤列出的声音

    Image-of-filter-categories-options。

  • 数据显示（Data Display）：右键点击标题栏将提供选择显示音频数据的选项

    Sounds-tab-data-display-options。

功能按钮

  • 声音上下文菜单：右键点击选中的声音将允许你将声音固定（Pin）到显示顶部、在内容浏览器中浏览到资产（Browse to Asset），或编辑（Edit）以从此窗口打开资产编辑器

    Sounds-menu-right-click-menu。

  • 静音已选择（Mute Selected）：在列表中选择声音时，按下静音已选择按钮将静音该声音资产

    Sounds-tab-with-mute-selected。

  • 独奏已选择（Solo Selected）：在列表中选择声音时，按下独奏已选择按钮将独奏该声音资产

    Sounds-tab-with-solo-selected。

  • 清除所有静音/独奏（Clear All Mutes/Solos）：重置为默认播放混音

声源选项卡

声源（Sources）选项卡在平面列表中显示音频混合器（Audio Mixer）的所有当前输入。 呈现的资产与声音选项卡中列出的资产一致，显示不同的音频数据。

Sources-tab-items-available。

显示的数据

  • 播放顺序（Play Order）：单调递增的声音实例ID，表示声音在混合器中开始的顺序

  • 名称（Name）：Uasset名称，不是运行时实例名称

  • Amp（峰值）：跟踪混合器源幅度的包络跟随器值

  • 音量（Volume）：此混合器源的所有音量控制和调制器的总和，不包括距离衰减，作为线性幅度倍增器的正浮点值

  • 距离衰减（Distance Attenuation）：基于从此混合器源到声音渲染器的距离的增益倍增器，从0.0到1.0的浮点值

  • 音调（Pitch）：此混合器源的所有音调控制和调制器的总和，作为线性播放速率倍增器的正浮点值

  • LPF：此混合器源的所有低通滤波器控制和调制器的总和，表示以赫兹为单位的截止频率

  • HPF：此混合器源的所有高通滤波器控制和调制器的总和，表示以赫兹为单位的截止频率

功能按钮

  • 数据过滤器（Data Filter）：右键点击列表标题栏将显示一个上下文菜单，用于选择每个混合器源显示的音频数据值

    Sources-tab-right-click-menu。

  • 全局静音/独奏（Global Mute/Solo）：此控制取决于文本窗口过滤的内容，M和S按钮将静音和独奏过滤的声源列表。 如果没有被过滤，按下M和S按钮将返回到默认混音。 这优先于声音选项卡上的任何静音和独奏操作

  • 显示/隐藏绘图（Show/Hide Plot）：按下选项卡右上角的绘图按钮将显示从表格中选择数据的时间图

    Sources-tab-show-hide-plot-icon

  • 编辑资产（Edit Asset）：双击列表显示中的混合器源将打开该资产的资产编辑器

绘图跟踪

如果选择了绘图跟踪（Plot Trace），声源选项卡的下半部分将显示最近5秒时间内所选数据的混合器源值历史的线图。 时间轴值来自跟踪的开始，通常是游戏会话的开始。 绘图数据值使用图右上角的下拉菜单选择，并以与上述数值显示相同的单位显示。 绘图跟踪将显示列表中的前16个源。

Plot-trace-line-graph。

虚拟循环选项卡

此选项卡显示了所有当前正被渲染器跟踪，但由于并发数限制或距离衰减因素而未为混音器生成样本的活跃声音列表。

Virtual-loops-tab-item-list。

显示的数据

  • 播放顺序（Play Order）：单调递增的声音实例ID，表示声音在混合器中开始的顺序

  • 名称（Name）：虚拟化混合器源的Uasset名称

  • 时间（虚拟化）（Time (Virtualized)）：此声音上次为混合器提供采样以来的时间（秒）

  • 时间（总计）（Time (Total)）：此声音播放的总时间（秒），包括虚拟和非虚拟

  • 更新间隔（Update Interval）：决定此声音是否保持虚拟的位置或并发更新之间的时间（秒）。 该值随与渲染器的距离而变化

功能按钮

  • 浏览（Browse）：此按钮将在内容浏览器（Content Browser）中显示选定的资产

  • 打开（Open）：此按钮将打开选定资产的资产编辑器

  • 数据过滤器（Data Filter）：右键点击列表标题栏将显示一个上下文菜单，用于选择每个混合器源显示的音频数据值

    Virtual-loops-tab-browse-open-right-click-menu。

  • 编辑资产（Edit Asset）：双击列表显示中的混合器源将打开该资产的资产编辑器

子混音选项卡

此选项卡列出当前项目中的所有声音子混音（Sound Submixes），并指示当前哪些有活动信号。 你可以选定一组子混音，使其信号电平显示在音频表（Audio Meters）选项卡中。

Image-of-the-submixes-tab。

显示的数据

  • 活动（Active）：此列中的点表示该子混音上的活动信号

  • 选择（Select）：勾选此列中的复选框，表示子混音电平正可视化显示在音频表选项卡的表上。 注意，如果音频表选项卡未显示在你的当前配置中，你需要手动打开它

  • 名称（Name）：声音子混音资产名称

功能按钮

  • 编辑子混音（Edit Submix）：双击列表中的子混音将打开该资产的资产编辑器

音频总线选项卡

音频总线（Audio Buses）是给定通道配置的缓冲区，任何音频源都可以向其“发送”音频。 发送到总线的音频会被混合成单个信号。 音频总线彼此之间不存在图形或关系上的连接。 它们主要用作执行音频分析的场所（例如 包络跟随），可以驱动其他系统，或者路由到“源总线”（将其输出转换为声源）或者从MetaSound中读取（并在MetaSound DSP图中进一步处理或分析）。

Image-of-the-audio-buses-tab。

显示的数据

  • 活动（Active）：此列中的点表示该音频总线上的活动信号

  • 选择（Select）：勾选此列中的复选框，表示音频总线电平正可视化显示在音频表选项卡的表上。 注意，如果音频表选项卡未显示在你的当前配置中，你需要手动打开它

  • 名称（Name）：音频总线资产名称

功能按钮

  • 类型过滤器（Type Filter）：使你能够显示音频总线资产、在代码中生成的总线，或两者都显示

    Audio-buses-type-filter-options。

  • 编辑音频总线：双击列表中的音频总线将打开该资产的资产编辑器

音频表选项卡

此选项卡显示在各选项卡中选择的子混音（绿色文本）和音频总线（蓝色文本）的电平表可视化显示。 电平表幅度使用对数dB刻度。 总线配置中的每个通道都有独立的电平表，按规范扬声器顺序排列。 窗口将滚动以容纳所有选定的子混音和总线。 此选项卡无控制选项。

 

Audio-meters-tab。

分析器选项卡

分析器（Analyzers）选项卡包含引擎主音频输出的5个实时可视化工具。 从选项卡右上角的省略号菜单中选择可视化工具。

Analyzers-tab-with-ellipses-menu-options-shown。

电平表（Meter）：以对数dB刻度显示主输出RMS幅度。 通道数与音频设备的通道配置匹配。 此分析器无其他控制选项。

Meter-numbers-with-a-bar-graph。

示波器（Oscilloscope）：显示来自主音频输出的最近0.5秒音频的时域采样幅度图。 刻度为从0.0到最大1.0的线性浮点值。 此分析器无其他控制选项。

Oscilloscope-line-graph。

矢量示波器（Vectorscope）：显示水平轴上左声道对垂直轴上右声道的线性时域幅度。 这有助于观察相位关系和通道相干性。 此分析器无其他控制选项。

Vectorscope-image。

频谱图（Spectrogram）：显示混合成单声道的最新音频输出的频域图。 时间显示在水平轴上，音频频率显示在垂直轴上。 图中的每条垂直线代表音频的单个时间窗口，像素颜色代表该频率下音频信号的功率。 该图有多个控制选项，通过右键单击分析器上的任意位置选择：

Spectrogram-image。

  • 分析器类型（Analyzer Type）：在快速傅里叶变换（FFT）和常数Q变换（CQT）之间选择，以在频域中表示音频信号

  • FFT大小（FFT Size）：每个窗口变换中使用的音频采样数。 更大的尺寸将提供更高的频率分辨率，代价是较低的时间分辨率

  • 像素绘图模式（Pixel Plot Mode）：在采样（Sample）、峰值（Peak）或平均值（Average）中选择如何加权采样以显示信号强度。 这可用于强调或不强调瞬态频率

  • 频率刻度（Frequency Scale）：选择线性或对数刻度以查看频谱中的不同细节

  • 颜色映射（Color Map）：选择白色或黑色代表更强的信号强度

  • 方向（Orientation）：选择水平（如上图）或垂直，交换轴线，使时间为垂直轴，频率为水平轴

频谱分析器（Spectrum Analyzer）：显示混合成单声道的主输出的瞬时频域图，水平轴为音频频率，垂直轴为信号强度。 将鼠标移动到特定频率将显示频谱该频段的信号强度。 此分析器有多个显示选项。

Spectrum-analyzer-line-graph。

  • 弹道学（Ballistics）：选择模拟（Analog）或数字（Digital），模拟音频窗口之间的信号持续性，以呈现模拟或数字专业音频电平表的外观。 这决定了帧之间的过渡可以多么平滑（模拟）或精确（数字）

  • 分析器类型（Analyzer Type）：在快速傅里叶变换（FFT）和常数Q变换（CQT）之间选择，以在频域中表示音频信号

  • FFT大小（FFT Size）：每个窗口变换中使用的音频采样数。 更大的尺寸将提供更高的频率分辨率，代价是较低的时间分辨率

  • 倾斜频谱（Tilt Spectrum）：对每个频率应用一定的衰减量，以平衡低频权重较大的频谱图

  • 像素绘图模式（Pixel Plot Mode）：在采样（Sample）、峰值（Peak）或平均值（Average）中选择如何加权采样以显示信号强度。 这可用于强调或不强调瞬态频率

  • 频率刻度（Frequency Scale）：选择线性或对数刻度以查看频谱中的不同细节

  • 显示频率轴标签（Display Frequency Axis Labels）：用赫兹为单位的数值标记水平图网格线

  • 显示声级轴标签（Display Sound Level Axis Labels）：用分贝为单位的数值标记垂直图网格线

控制总线选项卡

音频调制（Audio Modulation）插件使用户能够创建控制总线（Control Buses），可以修改音频源和子混音的音调、音量、滤波器和其他值。 此选项卡以数字形式显示每个活动总线的当前值，格式为0.0到1.0之间的浮点值。 声源（Sources）和声音（Sounds）页面上显示的音调、音量和滤波器值反映了此处显示的控制总线的影响。

Control-buses-tab。

此选项卡无其他显示或控制选项。

调制矩阵

音频调制（Audio Modulation）插件中的控制总线（Control Buses）可以叠加以产生累积效果。 调制矩阵（Modulation Matrix）选项卡用于显示当前活跃的不同总线及其如何协同影响音频源。

Modulation-matrix-tab。

此选项卡无其他显示或控制选项。

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page