跳到主要内容

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 类型)