Connecting to Wwise
Reagent talks to Wwise through the official WAAPI (Wwise Authoring API), so you’ll need WAAPI enabled in your Wwise project, if it isn’t already enabled by default:- In Wwise, open Project → User Preferences
- Enable Wwise Authoring API and Allow browser connections from: 127.0.0.1 with port 8090.
- Open a project in Wwise — Reagent auto-detects the running instance
Wwise Compatibility
Reagent is compatible with Wwise 2021.1 onwards. It has specialized knowledge based on the version and will self heal if API call was incorrect. The Wwise integration works on both Windows and MacOS.Exploring Wwise Integration
I’ve personally found Reagent x Wwise most helpful when it comes to debugging and checking project structure for silly mistakes. This has been a huge time saver for bigger projects.Live Mixing with Wwise
Reagent allows you to mix your Wwise project in real-time using natural language commands. Instead of guessing based on your current selection in Wwise, Reagent captures live data from the Wwise profiler. It automatically identifies the exact voice, switch, state, and RTPC values active the moment a sound plays, applying your changes with pinpoint accuracy.How to Use It
- Connect Wwise: Ensure Wwise is actively connected to your running game.
- Trigger the Sound: Play the game normally and trigger the audio asset you want to adjust.
- Command Reagent: Describe your changes in plain English. Reagent will look back at the profiler to target the correct object.
Example Commands
- 🗣️ “Make the dagger swing 3 dB louder.”
- 🗣️ “Turn up the tree emitter by 3dB.”
- 🗣️ “Bring the footsteps down 2 dB on grass but leave the wood surface alone.”
Safety & Project Control
Approval Before Writes
You remain in full control of your project data. Any command or script that modifies your Wwise project (such as mix changes or parameter tweaks) requires your explicit approval first.- What you see: Reagent displays a preview showing the exact target object and its proposed new value.
- Your options: You can accept or reject each change individually.
- Read-only exceptions: Structure checks, queries, and audio analyses run instantly without a prompt.
Automatic Rollback
Every modification Reagent writes to Wwise is wrapped in an undo group.- Self-Healing: If an execution fails halfway through, Reagent automatically rolls back all partial changes so your project is never corrupted.
- Manual Control: You can manually reverse the entire operation at any time directly inside Wwise by navigating to Edit → Undo.
Domain Knowledge
The Wwise Subagent draws on hand-authored domain knowledge — troubleshooting patterns, best practices, and many others — when answering questions and debugging. If you hit a tricky Wwise issue, just describe it and Reagent will pull in the relevant guidance into it’s own context.Audio Analysis on Wwise Source Files
The Wwise subagent can also reach into the source WAV files referenced by your Wwise Sound objects and run audio analysis on them. This is useful for tasks like loudness matching across siblings of a container, checking whether trim points need adjusting, or inspecting source content during an import.| Tool | What it does |
|---|---|
| Analyze RMS | Measures loudness of a source file (or a trimmed slice of it) for matching @VolumeOffset across siblings |
| Analyze Silence | Finds silent regions in the source — useful for verifying or tightening trim points |
| Analyze Transients | Locates hits and attacks within the source |
| Extract Waveform | Returns waveform peaks for visualization or alignment work |
| Extract Audio Metadata | Returns sample rate, channel count, duration, and bit depth |
@TrimBegin / @TrimEnd on Sound objects when analyzing — if trim points are unset (the Wwise default of -0.001), it analyzes the full file instead.