跳到主要内容

MetaSounds 集成

要求与限制​

版本要求

此集成仅适用于 UE >= 5.3。

有一个包含 MetaSounds 支持的 Runtime Audio Importer 独立版本：MetaSound Runtime Audio Importer

插件冲突

如果您已安装常规的 Runtime Audio Importer 插件，请在安装 MetaSound 版本之前将其移除。

当前限制

由于 MetaSounds 中尚未解决缩放问题，目前仅支持 已导入的 声波，不支持其衍生声波（例如，不支持 流式传输 和 可捕获的 声波）。

UE 5.6 已知问题

Unreal Engine 5.6 存在一个与断言相关的错误，在编辑器或开发版本中，将声音在运行时导入到 MetaSound 时可能导致崩溃。

解决方法：

  • 发布版本：使用 Shipping 配置设置打包您的项目 - 不会发生崩溃
  • 自定义引擎构建：如果您使用的是自定义 UE 5.6 引擎构建，请应用 此提交 中的修复
  • 升级到 UE 5.7：此问题已在 Unreal Engine 5.7 及更高版本中解决

如果您在编辑器或开发测试中使用 UE 5.6，请考虑上述解决方法或升级到 UE 5.7。

设置流程​

1. 启用 MetaSound 插件​

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

启用 MetaSound 插件

2. 配置 MetaSound 图表​

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

Imported Wave To Wave Asset 节点

转换后，您可以使用 Wave Asset 类型可用的所有相同功能，例如使用 Wave Player 节点播放它。

MetaSound 播放示例

实现工作流​

1. 导入并准备音频​

导入音频数据的工作流程与标准 Runtime Audio Importer 过程相同。但是，在您的声波准备就绪后，还必须调用适当的函数来准备声波以供 MetaSounds 使用。

为 MetaSounds 准备声波

2. 设置波形参数​

然后，您可以为您的 MetaSound 音频组件设置波形参数，并根据需要播放它。

设置波形参数节点

完整示例​

以下是一个完整的实现示例：

Blueprint实现​

为 MetaSounds 导入音频示例

MetaSound 图表​

在 MetaSounds 中播放音频示例

最佳实践​

在使用 MetaSounds 和 Runtime Audio Importer 时：

  1. 始终使用 PrepareSoundWaveForMetaSound 函数专门为 MetaSound 准备音效波形
  2. 在 MetaSound 图表中使用 ImportedWaveToWaveAsset 节点进行类型转换
  3. 请记住，目前仅支持 Imported 类型的音效波形（不支持 Streaming 或 Capturable 类型）
  4. 如果在 UE 5.6 中遇到崩溃问题，请参考上文的已知问题部分以获取解决方法