版本

menu_open
Wwise SDK 2023.1.3
Wwise 插件 ID

Wwise 插件通过公司 ID 和插件 ID 进行标识。这些 ID 的定义位于 plugin.xml 文件中。

  • Company ID(公司 ID):用于精确识别特定公司
    • EffectPlugin、 SourcePlugin、 ConversionPlugin 等标签的属性 CompanyID
    • 介于 0-4095 之间的 12 位无符号整数。
    • 0-63 预留给 Audiokinetic 使用。
    • 64-255 可用于内部插件开发。
    • 256-4095 由 Audiokinetic 指派给插件程序员。
  • Plug-in ID(插件 ID):用于精确识别指定 Company ID 对应的某个插件
    • EffectPlugin、 SourcePlugin、 ConversionPlugin 等标签的属性 PluginID
    • 介于 0-32767 之间的 16 位无符号整数。
    • 由插件程序员自由设定。
备注: Company ID 和 Plug-in ID 组合不可重复。

在 Wwise 和声音引擎中,公司 ID、插件 ID 与一个 4 位插件类型值组合后,构成了唯一的 32 位标识符。这些插件类型值在 AkPluginType enum (IAkEffect.h) 中定义,如下所示:

  • AkPluginTypeNone = 0,供 Audiokinetic 内部使用
  • AkPluginTypeCodec = 1,转换插件
  • AkPluginTypeSource = 2,源插件
  • AkPluginTypeEffect = 3,效果器插件
  • Audiokinetic 公司 ID 和插件 ID
备注: 这个 4 位的插件类型值与 ID 的唯一性无关:Wwise 的 Plug-in Manager 将确保公司 ID 和插件 ID 的组合不会存在重复,不论其属于何种插件类型。

封装后的 32 位类 ID 组合如下:插件 ID + 公司 ID + 插件类型 == 封装后的 32 位类 ID。因此当插件 ID 为 1、公司 ID 为 0 并且插件类型为 1 时,封装的 32 位类 ID 为 0x00010001。

备注: 按照 AkTypes.h 中的 AKCOMPANYID_AUDIOKINETIC 定义所述,所有 Audiokinetic 插件(转换插件、源插件和效果器插件)的公司 ID 均为 0,如 。

示例

以下是一个虚构的效果器插件的示例:

  • Company ID: 72
  • Plugin ID: 5

XML:

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (C) 2020 Audiokinetic Inc. -->
<PluginModule>
<EffectPlugin Name="FictionalDelay" CompanyID="72" PluginID="5">
...

Plugin Factory:

...
AK_IMPLEMENT_PLUGIN_FACTORY(FictionalDelayFX, AkPluginTypeEffect, 72, 5)
...
@ AkPluginTypeEffect
Effect plug-in: applies processing to audio data.
Definition: AkTypes.h:1253

此页面对您是否有帮助?

需要技术支持?

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

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

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

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

开始 Wwise 之旅