Blog homepage

Getting started using the Wwise Authoring API (WAAPI) with Max 8

Wwise Tips & Tools

Introduction

When setting up more complex RTPC-driven events in Wwise, we often face the dilemma of not being able to easily test drive them. 

We can’t really control more than one parameter at once using a mouse, and while mapping parameters to MIDI controllers or using MIDI automation works, it might not be ideal. 

Testing directly in game can also be cumbersome and slow down the iteration process if there are no shortcuts in place to skip to the things/scenarios we want to test, or if the systems we are designing audio for aren’t fully implemented yet, or don’t exist at all.

Max by Cycling74 could help with all of that. With NodeJS it offers a way to connect to Wwise directly via WAAPI, allowing to call events and update RTPCs.

It also provides many useful graphical UI objects like curves, sliders, buttons, dials. It has built-in snapshot saving to store presets of different parameter configurations, and it allows simulating parallel parameter changes over time. It is a great environment for rapid prototyping.

A final note before we dive in: there will be a link to the project on my github at the end of the article :).

waapi1

Setup

To follow this article and to make the most out of this you need:

  • a recent installation of Wwise including the Sample Project
  • Max 8 (the trial should theoretically work but I haven’t confirmed)
  • a basic understanding using Max
  • decent knowledge in javascript programming

Note that the screenshots were all made on OSX but the steps are identical on Windows.

First we need to create a Max Project, instead of a simple Max Patcher, because we want everything contained in its own folder. In the Max project folder we create a code sub directory and copy the contents from the hello-wwise-node-wamp example project which can be found here: 

<WwiseInstallationPath>/SDK/samples/WwiseAuthoringAPI/js/

Additionally we copy the wwise.js file from 

<WwiseInstallationPath>/SDK/include/js/

into the code folder of our Max project, so we can easily reference it in the index.js script.

waapi2

Then we add a node.script object to our patcher and point it to the index.js file that comes with the hello-wwise-node-wamp example, open the object help patcher (ALT+Click on the Max object) and copy the node debug tool into our patch.

Side note: by default Max will open the js file in its functional but a bit limited built-in text editor. If you, like me, prefer to use VSCode or another editor you can change that in the Max preferences.

Finally we send the node.script a script npm install message. This will install all the node modules listed in the packages.json file.

In our Wwise project we now need to confirm that WAAPI is enabled in the Wwise User Preferences.

waapi3

Next we open the index.js by using CTRL+Double Clicking it, update the path of the wwise.js file to our local copy, include the max-api module and finally replace the console.log() calls with Max.post() calls to print to the max console.

code

Now it’s time to test the connection; for that we enable capture in Wwise and navigate to the WAAPI section of the log window in the Profiler view, then test the connection sending a script start message to the node object in Max.

If everything went well, the Max console should print a hello message and the Wwise version and the Wwise Log as well.

Note that in the index.js provided by the SDK sample, the connection is closed immediately again.

To change that, we modify the onopen() function to cache the akSession and also add an exit handler for the node process to close the WAAPI connection when the node script is stopped.

waapi4

Next we add MaxHandlers for posting events and updating RTPCs by UUID. I chose UUID deliberately because I had some issues with posting RTPCs by name.

waapi5

Next we need the UUIDs of the events and RTPCs we want to call from Max. Thankfully Wwise provides WAQL , a sophisticated query language that makes this very easy. We add two additional max handlers which return all Events/RTPCs and send them to the first outlet of the Max node object which we can connect to a Max dictionary that we can embed permanently in the patcher to access the UUIDs whenever we need them at a later point.

waapi6

waapi7

Now that we have the UUIDs at hand we can finally post our first events. I’m using the NYC ambiance events for testing. Our postEvent() Handler takes three arguments, an event name, a UUID and an object ID.

This object ID is important later, for both the play/stop events as well as the RTPC updates we plan on sending later it needs to match. Or otherwise the stop/RTPC updates won’t work since Wwise thinks they’re not related.

Here’s a final video of the aforementioned example project driving the Time and Rain_Intensity parameter on the NYC ambiances of the Wwise SampleProject.

And here’s the link to the sample project on github. Just download it as .zip and open it in Max 8.

What’s next?

Of course this all still requires a lot of manual setup to get Wwise events setup in a Max patch, but Max also supports patcher scripting via javascript, including programmatically creating objects, etc., so all of this can be automated.

I’ve started experimenting with ways to automatically create event buttons, etc. which, if it goes anywhere, might eventually turn into a small Max package.

Happy patching!

Additional Resources

Michael Hartung

Michael Hartung

Michael Hartung is a Technical Sound Designer from Munich, Germany. Since 2015 he's been working on a variety of Indie and VR Games on his own as well as Technical Sound Designer on various projects for Formosa Interactive UK and Dynamedion Germany.

hartung.studio

Comments

Leave a Reply

Your email address will not be published.

More articles

Authoring Plug-ins for Wwise 2021.1 | Part 1: History and Goals

One of the least known characteristics of the Wwise ecosystem is its extensibility. Companies create...

5.2.2021 - By Michel Donais

On working with WAAPI and Python in a team, with examples

In this article, I’d like to describe a somewhat opinionated approach to working with WAAPI that...

26.1.2022 - By Eugene Cherny

Improving the Wwise Unreal Integration

The introduction of the Event-Based Packaging (EBP) asset management workflow in Wwise 2019.2.1 was...

2.2.2022 - By Guillaume Renaud

Wwise 2022.1 | What's New

Wwise 2022.1 is live and now available to install from the Audiokinetic Launcher. Here is a summary...

15.11.2022 - By Audiokinetic

Wwise 2023.1 What's New

Wwise 2023.1 is live and now available to install from the Audiokinetic Launcher. Here is a summary...

6.7.2023 - By Audiokinetic

Wwise Beginners: 10 Questions Answered

Learning a new software can be a challenging process, yet exciting and rewarding at the same time....

6.3.2024 - By Mads Maretty Sønderup

More articles

Authoring Plug-ins for Wwise 2021.1 | Part 1: History and Goals

One of the least known characteristics of the Wwise ecosystem is its extensibility. Companies create...

On working with WAAPI and Python in a team, with examples

In this article, I’d like to describe a somewhat opinionated approach to working with WAAPI that...

Improving the Wwise Unreal Integration

The introduction of the Event-Based Packaging (EBP) asset management workflow in Wwise 2019.2.1 was...