One Minute Wwise | Creating a Wwise Plugin
How to create a very simple Wwise gain plugin and how to use it in Wwise. No commercials, no lengthy introductions!
Let's create a simple Wwise Gain Plugin. To do so...
1. Create a new plugin...
2. ... add some processing code, and map it to a property ...
3. ... then build and use it in Wwise.
But before we do so, start by installing...
* ... Python with these libraries ...
* ... Visual Studio with this Windows SDK version ...
* ... and Wwise along with the platforms you need it for.
We'll just be making a Wwise Gain plugin for Authoring. Okay, let's navigate to the directory of where you want to create the plugin. Then access command prompt, like this. Then create a new plugin based on this wp.py file, from your Wwise version, choose effect and premake it, which creates a solution we can use with Visual Studio. Here, in the XML we've got this dummy property that remains to be used for something. Let's use it to control the gain level. So in the FX.cpp file, in execute, let's multiply the samples with the dummy property. And for proper dB scaling, convert the multiplication like this, add a decibels flag in the XML, and change the value restriction. Okay, so set it to release, save, and build it. And then add it to a sound in Wwise. That's it!
Resources:
* Creating the Authoring Plugin Part: https://hubs.ly/H0vpVZ60
* Creating the Sound Engine Plugin Part: https://hubs.ly/H0vpV-l0
* Prerequisites to working with plugins: https://hubs.ly/H0vpVKw0
* Wwise plugin ADC presentation: https://www.youtube.com/watch?v=MOZPi2rtfQo
* Custom XML Property Descriptions (Like "DataMeaning"): https://hubs.ly/H0vsdgg0
* More on AK_DBTOLIN: https://hubs.ly/H0vslHX0
* Simple 3D Plugin: https://www.platinumgames.com/official-blog/article/10027
* Simplified plugin pipeline: https://blog.audiokinetic.com/a-simplified-pipeline-for-creating-wwise-audio-plug-ins/
* Sam Mackie's Wwise Plugin Github: https://github.com/sgmackie/Wwise_Plugins
* Quantum Break Wwise Plugin: https://audiomediainternational.com/2016/04/11/the-audio-mechanics-of-quantum-break/
* Get Visual Studio: https://visualstudio.microsoft.com/
* Get Python: https://www.python.org/downloads/
Want to find more examples of Wwise plugins?
- Go to your "Wwise installation"/SDK/samples/Plugins folder.
What solution to open with Visual Studio:
vc140 - Visual Studio 2015
vs150 - Visual Studio 2017
vs160 - Visual Studio 2019