Version

menu_open

Wwise Source and Effect Plug-in Troubleshooting Guide

Problem: At startup, Wwise displays an error message stating that two plug-ins have the same Company ID and Plug-in ID.

  • Each plug-in must have a unique Company ID / Plug-in ID combination. Refer to WwiseObject Elements for details on how to define these IDs.

Problem: My plug-in is not available to the user in Wwise.

My plug-in is not available to the user on Mac but works on PC.

  • Your plug-in needs to be a 64-bit DLL. Wwise authoring only runs in 64 bits on Mac.
  • Your plug-in XML and DLL were not included in the Codeweavers CrossOver list. See Installation on macOS for instructions.

Problem: One of the controls in my plug-in's user interface is empty or disabled.

  • Verify that the property name specified in the control's text in the resources (for example Prop=SineFrequency) is the same as the name specified in your plug-in description file (for example Property Name="SineFrequency"). Refer to "Prop" Control Attribute and Properties Element for more information.
  • Verify that the control class (for example Class=SuperRange) is suitable for the property's type. Refer to "Class" Control Attribute and Properties Element for more information.

Problem: One of the Wwise controls in my plug-in's user interface does not appear correctly.

Problem: My plug-in doesn't recognize property changes in the UI.

  • Verify that the AudioEnginePropertyID specified in your plug-in definition file is in the 0-32767 range. Refer to Properties Element for more information about the AudioEnginePropertyID tag.
  • Verify that the AudioEnginePropertyID specified in your plug-in definition file matches the ID you use in your implementation of AK::IAkEffectParam::SetParam(). Refer to Properties Element for more information about the AudioEnginePropertyID tag, and AK::IAkPluginParam::SetParam() for details about implementing AK::IAkEffectParam::SetParam().

Problem: My plug-in works in Wwise but not in my game

There are two possibilities:

  • If your game statically links the effects, make sure you link the plug-in library and include the corresponding factory header file in one of the CPP files.
  • If your game uses dynamic libraries (such as DLL, SO, and PRX), make sure your effect DLL is copied in the same folder as the executable. Or set AkInitSettings::szPluginDLLPath to add a DLL search path, if they are not in the same folder.

Problem: My plug-in doesn't work in Unity

Here are a few points to validate for new plugins in Unity.

  • Plugins loaded by Wwise in Unity must be copied to \Assets\Wwise\Deployment\Plugins\[Platform]\DSP. Usually this is the Release version.
  • There must be a Windows\x86, Windows\x86_64 and a Mac version of the plug-in so the plug-in can work in the Unity Editor.
  • The standard Unity integration will detect the plug-in usage from the PluginInfo.xml that is created when generating the banks. The "DLL" tag in PluginInfo.xml comes directly from the "EngineDllName" tag written in the XML file describing the plug-in in the Wwise authoring folders. Make sure your DLL has the same name.

Refer to Plug-in Static Registration for more details.


Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise