音频调制参考指南

音频调制（Audio Modulation）插件可以对组件（Component）和蓝图（Blueprint）系统中的浮点音频参数（例如音量和音高）进行动态控制。

资产类型

共有五种资产类型可以提供音频调制（Audio Modulation）的功能。

你可以使用这些资产为调制通道奠定基础，然后再将调制通道连接到端点调制目标。

要创建音频调制资产，请执行以下步骤：

1. 在内容浏览器（Content Browser）中点击添加（Add）按钮。

2. 找到音频（Audio ）>调制（Modulation），选择所需资产类型。

调制参数

调制参数（Modulation Parameter）为调制值的规格化、显示和值与值之间的混合提供上下文。

各个调制参数的基础属性如下（根据类的不同，还具有其他属性）：

• 默认参数值（Default Parameter Value）：默认调制值。 该值起到旁通值的作用，应进行设置，以便引用此参数的调制器与另一个调制器混合时不会改变输入。 从数学上来说，选择的值应该使得在设置为输入时将混音函数有效地简化为恒等函数。

• 单位显示名称（Unit Display Name）：虚幻编辑器中引用时显示的单位。 此信息仅用于开发目的，因为打包版本中已删除此属性。

内置有多个调制参数类，可支持各种用例，包括音量混合和频率调整。

关于调制值

调制值可以在两个值空间之间变换，即：

• 单位（Unit）：与调制参数关联的单位值。 例如，音量调制参数的单位为分贝（dB）。 单位值会被映射到规格化值。

• 规格化（Normalized）：规格化值，范围为0.0至1.0，用于统一的传递和混合。

当多个调制器链接到单个调制目标时，调制值会混合。 调制值的组合方式取决于关联的调制参数。 以下示例展示了部分内置调制参数类型对混音的处理方式：

• 音量（Volume）：音量的降低是可累加的。 例如，如果两个控制总线的值分别为-6 dB和-12 dB，那么调制目标的音量将被设置为-18 dB。

• 高通滤波器频率（High-Pass Filter Frequency）：选择最高值。 例如，如果两个控制总线的值分别为1000Hz和500Hz，那么调制目标的高通滤波器频率将被设置为1000Hz。

• 低通滤波器频率（Low-Pass Filter Frequency）：选择最低值。 例如，如果两个控制总线的值分别为1000Hz和500Hz，那么调制目标的低通滤波器频率将被设置为500Hz。

创建自定义调制参数类

要创建自己的调制参数类，你可以继承USoundModulationParameter基类，并实现以下函数：

• GetMixFunction：预期会返回一个混合输入值和输出值的函数。

• GetUnitConversionFunction：预期会返回一个将值变换为单位空间的函数。

• GetNormalizedConversionFunction：预期会返回一个将值变换为规格化空间的函数。

如需详细信息，请参阅音频调制C++ API参考。

控制总线

控制总线（Control Bus）是引用调制参数的连接器。 控制总线可以：

• 由控制总线混合和调制发生器用于调制。

• 被参数预设配置引用和重新映射。

控制总线属性

控制总线混合

控制总线混合（Control Bus Mixes）是调制器，能让你：

• 同时影响多个控制总线值。

• 使用与其他控制总线混合共享的控制总线进行调制。

• 使用混音配置文件实时测试和调整音频。

控制总线混合属性

控制总线混合的属性已更新，一些涉及控制总线混合的函数具有新时长和激活时重新触发变量的输入：

参数预设配置

参数预设配置（Parameter Patches）是连接器型调制器，有两种主要用途：

• 将一个或多个控制总线值变换为单一输出值。

• 你可以将其用于自定义控制总线值的曲线，这有助于值的重新映射和创建不同的淡入淡出效果。

参数预设配置属性

调制发生器

调制发生器（Modulation Generators）是连接器型调制器，可随时间推移产生值。 若要进行调制，在控制总线或调制目标属性上进行设置即可。

此插件能提供以下类型的实现：

• 低频振荡器（LFO）：根据给定波形（例如正弦波或方波）的振荡生成数值。

• 包络跟随器：根据给定音频总线的振幅生成数值。

• 起音衰减波封：根据给定起音衰减波封生成数值。

创建自定义调制发生器

你可以按照提供给USoundModulationGenerator类的代码生成模板创建自己的调制发生器。该模板可为发生器的创建和注册生成所需的样板代码。

要创建USoundModulationGenerator类，请执行以下步骤：

1. 选择工具（Tools） > 新C++类（New C++ Class）。

2. 从选择父类（Choose Parent Class）窗口中选择所有类（All Classes）。

3. 在SoundModulatorBase下选择SoundModulatorGenerator。

必须实现以下函数：

• GetValue：将返回0.0和1.0之间的缓存、规格化、无单位的值。 该值用于监听调制目标。

• Update：将实现下一帧缓存值的计算。

你还可以选择实现以下函数：

• IsBypassed：将根据发生器值是否应该包含在目标计算中返回一个布尔值。 默认情况下，它会将源自生成的USoundModulationGenerator Bypass属性的值转发给虚幻音频引擎。

• GetDebugValues：将为每个发生器实例提供字符串数组，以便在运行时使用非发布构建中的au.Debug.SoundModulators系列调试命令显示。

• GetDebugCategories：将提供与这些实例值提供的值相对应的字段名称的静态数组。

如需详细信息，请参阅音频调制C++ API参考。

调制目标

调制目标（Modulation Destination）是音频对象所附的端点，为该对象（按指定单位）提供基础浮点值，并且该值可以通过音频调制资产进行调制。

以下对象拥有调制目标：

• 声波

• MetaSound源

• 音频组件

• 合成组件

• 音效类

• 子混音

• 源效果（仅限BitCrusher和Chorus）

你可以在细节（Details）面板的调制（Modulation）模块中找到每个支持音频对象的调制目标。 每个对象都列出了支持的调制目标类型，这些类型决定了调制属性，如音量或音高。

要使用调制目标，必须启用相关的调制（Modulate）复选框，然后将所需的连接器（控制总线、调制发生器或参数补丁）添加到数组。

调制目标路由选项

某些调制目标（比如音频组件的调制目标）能提供基于继承的路由选项。 子对象可以从父对象继承调制路由。 具体来说，音频组件可以从所附的声音资产继承，声音可以从所附的音效类继承。

MetaSound集成

音频调制插件提供下列MetaSound节点：

• Get Modulator Value：返回给定的调制器数值，可能是规格化数值或单位空间数值。

• Mix Modulators：返回两个给定调制器之间的混合参数值，可能是规格化数值或单位空间数值。

有关MetaSound的更多信息，请参阅MetaSound文档。

音频调制与并发

有一个CVar可用，它使源上的音量调制影响并发中的Stop Quietest选项。 它的名称是： au.Concurrency.IncludeVolumeModulation

你可以通过双击并发资产，在并发选项卡的解决规则下找到该菜单。

• 当设置为0时，音量调制不包括在并发评估中。

• 当设置为1时，音量调制将包含在一次性声音中，但不包括循环声音。

• 当设置为2时，音量调制包含在所有声音中

蓝图API概览

使用蓝图可以动态地创建和控制调制通道，并驱动其他系统，例如Gameplay或视觉效果等。

大部分和音频调制相关的蓝图函数都位于音频（Audio） > 调制（Modulation）下。 函数概览见下表。

如需详细信息，请参阅音频调制蓝图API参考。

关于UObject和代理

使用音频调制组件和资产时，通常要编辑UObject值。 但出于以下两个原因，音频调制不会直接使用UObject进行处理。

• UObject在游戏线程上运行。

• UObject可能会在音频调制系统无法控制的时间被执行垃圾回收。

因此，UObject中设置的值会被发送到音频渲染线程上音频调制系统中的对象。 必须牢记这一点，因为有些蓝图函数会编辑UObject，而其他函数则会修改音频调制系统中的代理对象。

如果函数只修改UObject值，则需要调用Update蓝图函数将这些更改发送到代理对象。 此外，如果先调用一个不修改UObject值的函数，再调用一个更新代理的函数，UObject值将重载代理。