跳到主要内容

MetaSounds 集成

要求与限制

:::重要 版本要求 该集成仅适用于 UE >= 5.3 版本。 :::

我们提供了支持 MetaSounds 的 RuntimeAudioImporter 专用版本:MetaSound RuntimeAudioImporter

:::警告 插件冲突 如果您已安装常规版 RuntimeAudioImporter 插件,请先卸载后再安装 MetaSound 版本。 :::

:::注意 当前限制 由于 MetaSounds 尚未解决的扩展性问题,目前仅支持 Imported 声波类型,不支持其衍生类型(例如 StreamingCapturable 声波)。 :::

设置流程

1. 启用 MetaSound 插件

首先需要为项目启用 MetaSound 插件。

启用 MetaSound 插件

2. 配置 MetaSound 图表

在 MetaSounds 编辑器中,创建一个新的 Imported Wave 输入,并使用 ImportedWaveToWaveAsset 节点将其转换为 Wave Asset 类型。

Imported Wave 转 Wave Asset 节点

转换完成后,您可以使用所有适用于 Wave Asset 类型的功能,例如通过 Wave Player 节点播放。

MetaSound 播放示例

实现工作流

1. 导入并准备音频

音频数据的导入流程与标准 RuntimeAudioImporter 流程相同。但在声波准备就绪后,您还需要调用特定函数来为 MetaSounds 准备声波。

为 MetaSounds 准备声波

2. 设置波形参数

然后您可以为 MetaSound 的音频组件设置波形参数,并按需播放。

设置波形参数节点

完整示例

以下是完整实现示例:

蓝图实现

为 MetaSounds 导入音频示例

MetaSound 图表

在 MetaSounds 中播放音频示例

最佳实践

使用 MetaSounds 和 RuntimeAudioImporter 时:

  1. 始终使用 PrepareSoundWaveForMetaSound 函数专门为 MetaSound 准备声波
  2. 在 MetaSound 图表中使用 ImportedWaveToWaveAsset 节点进行类型转换
  3. 请记住目前仅支持 Imported 声波(不支持 Streaming 或 Capturable 类型)