版本

menu_open
Wwise SDK 2021.1.14
音频插件

Wwise 允许通过构建自研插件来扩展其功能。您可以创建不同类型的插件,如音频效果器和音频源(以物理建模、调制合成、采样合成等方式生成音频)。

备注: 若想详细了解如何逐步创建插件,请参阅 开发低通滤波器插件 章节。

插件概述

Wwise 音频插件包含两个部分:设计工具部分和 声音引擎部分。

插件设计工具部分概述

该部分在 Wwise 设计工具中运行。其可在以下位置找到:

  • <Wwise>/Authoring/x64/<Config>/bin/Plugins

它包含两个文件:

  • XML 定义:定义模型(即插件的属性)。
  • 动态库 (.dll):提供 SoundBank 生成和图形界面的实现。

有关如何编写插件这一部分的信息,请参阅 编写音频插件的设计工具部分 章节。

备注: 若想更新现有插件,请参阅 迁移至 2021.1 设计工具插件 API 章节。

插件声音引擎部分概述

该部分在声音引擎中运行,其可依据用户在 Wwise 中定义的设置来生成或修改输入声音。这些设置作为 SoundBank 中的参数提供给声音引擎。

代码以静态库和动态库的形式提供给支持的平台。 声音引擎插件库文件与 Wwise 库一并存放在 SDK 中:

  • <Wwise>/SDK/<Platform>/<Config>/bin
  • <Wwise>/SDK/<Platform>/<Config>/lib

Wwise 的 include 目录下还包含以下头文件:

  • <Wwise>/SDK/include/AK/Plugin

静态库还可链接到设计工具动态库,进而用在 Wwise 设计工具中。

请参阅 编写音频插件的声音引擎部分 了解有关编写插件的这部分工作的信息。

插件创建资源

我们可以利用很多资源来轻松创建插件,其中最主要的一种方式就是使用开发工具 wp.py(Wwise 插件)。

开发工具:wp.py

在安装 Wwise SDK 时会配套提供采用 Python 编写的命令行工具(与 Python 2 和 3 均兼容)。 其可在 Wwise 安装目录下找到:

  • <Wwise>/Scripts/Build/Plugins/wp.py
备注: 须从工作目录而非安装位置运行 wp.py。比如:
C:\Workspace> python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" --help

工具的功能包括:

  • 通过模板生成即时可用的工程。
  • 生成针对目标平台的解决方案。
  • 构建这些解决方案。
  • 将开发的插件打包以便用在 Audiokinetic Launcher 中。

如需了解此 SDK 配套提供的插件开发工具,请参阅 使用开发工具

创建简单的低通滤波器插件

有关如何逐步开发功能插件的示例,请参阅 开发低通滤波器插件 章节。

示例代码

为便于快速入门,Wwise SDK 提供了即时可供构建的示例插件。其可在以下位置找到:

  • <Wwise>/SDK/samples/Plugins

提供的示例插件如下:

请参阅 效果器插件示例 了解有关此 SDK 随附的效果器示例的信息。

相关页面

以下各节提供了详情:


此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅