跳到主要内容

MetaSounds 集成

要求与限制​

版本要求

该集成仅适用于 UE >= 5.3 版本。

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

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

:::注意 当前限制 由于 MetaSounds 尚未解决的扩展性问题，目前仅支持 Imported 声波类型，不支持其衍生类型（例如 Streaming 和 Capturable 声波）。 :::

设置流程​

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