SoundTeG Ambisonic Decoder
SoundTeG Ambisonic Decoder is an effect plug-in that turns ambisonic audio into loudspeaker feeds for a custom loudspeaker layout. It uses the same ACN/SN3D format as Wwise. Each loudspeaker’s azimuth and elevation are configurable. Available decoding methods include SAD, MMD, EPAD and ALLRAD. MaxrE weighting improves directional focus. Phantom loudspeakers contribute virtual positions to ALLRAD’s 3D triangulation while their output channels remain muted. The plug-in supports RTPCs and provides 2 to 36 outputs, limited by the number of ambisonic input channels.
Main benefits
- Custom loudspeaker layouts
Configure 2 to 36 outputs and position each loudspeaker independently using azimuth and elevation controls. - Decoding methods and directional focus
Choose SAD, MMD, EPAD or ALLRAD decoding, and apply maxrE weighting to improve directional focus. - Phantom loudspeaker positions for ALLRAD
Use phantom loudspeaker positions to shape ALLRAD’s 3D triangulation while their output channels remain muted.
Key requirements
- The decoder runs on an Audio Bus with its Bus Configuration set to Ambisonics. The output count, including phantom channels, must not exceed the number of ambisonic input channels.
- ALLRAD needs at least four distinct loudspeaker positions forming a 3D layout around the listener. Phantom loudspeaker positions count toward this layout.
On this page
- Setup guide
- 1. Install the plug-in
- 2. Create a project and import the presets
- 3. Create an ambisonic bus
- 4. Add SoundTeG Ambisonic Decoder
- 5. Configure the loudspeaker layout
- 6. Create and position a test sound
- 7. Route the sound to the ambisonic bus
- 8. Monitor the decoded output
- 9. Configure multichannel hardware output
- Plug-in properties
- RTPC setup
- Troubleshooting
- Demo: My World
Setup guide
This guide uses Wwise version: 2025.1.12.9287. The screenshots in this walkthrough were captured on Windows. Click any screenshot to open a larger view.
1. Install the plug-in
Download the SoundTeG Ambisonic Decoder ZIP package that matches your Wwise version.
Version 2024.1.17.9170
Version 2025.1.12.9287
Version 2026.1.3.9276 BETA 3
1. Open the Audiokinetic Launcher and select Plug-ins. Choose the Wwise version used by your project. Under INSTALL NEW PLUG-INS, choose Add from archive from the menu beside Add from directory.

2. Select SoundTeG_Ambisonic_Decoder.zip from your download location and click Open. You can leave the package as a ZIP; extraction is not required.

3. Confirm that SoundTeG Ambisonic Decoder is selected and that the Wwise version matches your project. Click Install, or Modify if that is the button shown, and wait for the operation to finish.
If you already extracted the ZIP, choose Add from directory and select the extracted package folder instead. For Unity or Unreal projects, also check the Sound Engine library troubleshooting notes below.

2. Create a project and import the presets
Create a new Wwise project. Under Import factory assets to project, select SoundTeG Ambisonic Decoder to include the loudspeaker-layout presets.

3. Create an ambisonic bus
Under Main Audio Bus, create a child Audio Bus. The example names this bus SFX_5OA.

Set its Bus Configuration to the ambisonic order required by your project. The screenshot uses Ambisonics 5th order.

4. Add SoundTeG Ambisonic Decoder
Open the bus’s Effects tab and add SoundTeG Ambisonic Decoder.

Open the effect to see its controls. Select a property to read its description in the Contextual Help panel.

5. Configure the loudspeaker layout
Choose a preset from the preset menu, or configure the layout using Outputs and each speaker’s Azimuth, Elevation, and Phantom controls. The property reference below explains these settings.

6. Create and position a test sound
Create a Sine source under a Contents Work Unit for the playback test.

To position the sound relative to the listener in a game, open Positioning, enable Listener Relative Routing, and set 3D Spatialization to Position + Orientation. The example uses Emitter for 3D Position.

7. Route the sound to the ambisonic bus
On the sound’s Routing tab, set Output Bus to the ambisonic bus created earlier.

8. Monitor the decoded output
Select the ambisonic bus in the Meter view.

Play the test sound and inspect the meters while checking the configured loudspeaker layout.

9. Configure multichannel hardware output
If you need multichannel hardware output, create a SoundTeG Multichannel Output Audio Device. Follow the SoundTeG Multichannel Output guide to assign it to Main Audio Bus and select the hardware.

Plug-in properties
| Property | Description |
|---|---|
| Outputs | The total number of speaker outputs calculated by the decoder. Range: 2–36 outputs. |
| Decode Method | The method used to convert the ambisonic input into audio for the selected loudspeaker layout. See the method table below. |
| Apply MaxRE | Applies energy-vector (max-rE) weighting to the decoding matrix. This is used to improve directional imaging and reduce coloration when the listener is outside the exact sweet spot. |
Decode Method
| Value | Method |
|---|---|
| 1 — SAD | Sampling Ambisonic Decoder |
| 2 — MMD | Mode Matching Decoder |
| 3 — EPAD | Energy-Preserving Ambisonic Decoder |
| 4 — ALLRAD | All-Round Ambisonic Decoder |
CPU usage: ALLRAD may use more CPU, especially with higher ambisonic orders or more output speakers.
Speaker position and phantom channels
The following properties are available for each of the 36 speaker channels.
| Property | Description |
|---|---|
| Azimuth | Defines the horizontal angle of the speaker. |
| Elevation | Defines the vertical angle of the speaker. |
| Phantom | Marks the channel as an imaginary loudspeaker. ALLRAD uses its direction to help maintain a stable sound field where real speakers are missing, such as below the listener. |
A phantom channel outputs no sound in any decoding method. Enable Phantom for a direction with no real speaker.
RTPC setup
Control properties with Game Parameters
Decoder properties can be controlled through RTPCs. Open the decoder’s RTPC tab to bind a property to a Game Parameter.

Optional: create the RTPCs with the helper script
The create_decoder_rtpcs.py helper creates or updates 111 Game Parameters and their bindings for a selected decoder instance. It requires Python 3.9 or later and uses Wwise Authoring’s WAAPI connection. No additional Python packages are required.
create_decoder_rtpcs.py
- Keep the Wwise project open and enable WAAPI in Wwise User Preferences. The helper uses the local HTTP port 8090 by default.
- Select the bus containing the decoder instance you want to configure. If several instances exist, work on one instance at a time.
- Open a command prompt. Replace the example path below with the location where you saved the script.
- Run the command, check the reported result, then open the decoder’s RTPC tab and save the Wwise project.
python "path/to/create_decoder_rtpcs.py" --apply
You can type python , drag the script file into the command prompt to insert its path, and append --apply. Running the script without --apply previews the changes.


Troubleshooting
The plug-in works in Wwise but is missing in the game
SoundTeG plug-ins are third-party Wwise plug-ins. Installing a plug-in in Wwise does not guarantee that its Sound Engine library is present in your Unity or Unreal project. If the game reports a missing plug-in or cannot load it, copy the matching Sound Engine library into the game project manually.
Close the game editor before copying files. Match the Wwise version, platform, architecture, and build configuration used by the game. In the paths below, <Configuration> means one of Debug, Profile, or Release; it is not a combined folder name. Use the Sound Engine library from SDK, rather than the Authoring library from Authoring.
Unity on Windows
Copy SoundTeG_Ambisonic_Decoder.dll from the matching SDK configuration:
C:\Audiokinetic\Wwise_2025.1.12.9287\SDK\x64_vc170\<Configuration>\bin
Paste it into your Unity project’s Windows DSP folder:
<Unity project>\Assets\Wwise\API\Runtime\Plugins\Windows\x86_64\DSP
Unity on macOS
Copy libSoundTeG_Ambisonic_Decoder.dylib from the matching macOS SDK configuration. On a Mac, the source is:
/Applications/Audiokinetic/Wwise_2025.1.12.9287/SDK/Mac_Xcode2600/<Configuration>/bin
If the macOS platform libraries were installed with Wwise on Windows, the source is:
C:\Audiokinetic\Wwise_2025.1.12.9287\SDK\Mac_Xcode2600\<Configuration>\bin
Paste the library into your Unity project’s Mac DSP folder:
<Unity project>/Assets/Wwise/API/Runtime/Plugins/Mac/DSP
Rename only the copied file’s extension from .dylib to .bundle. Keep the filename and lib prefix:
libSoundTeG_Ambisonic_Decoder.dylib → libSoundTeG_Ambisonic_Decoder.bundle
Reopen Unity and check that the copied plug-in is enabled for its target platform in the Inspector. Use the same Wwise version for Authoring, the game integration, and the copied library.
Unreal Engine
For Windows desktop runtime loading, copy SoundTeG_Ambisonic_Decoder.dll from the Windows SDK folder above into the matching platform and configuration folder in your Unreal Wwise integration:
<Unreal project>\Plugins\WwiseSoundEngine\ThirdParty\x64_vc170\<Configuration>\bin
Older integrations may use Plugins/Wwise/ThirdParty. If Wwise is installed at engine level, use that integration’s ThirdParty folder instead. A .lib file does not replace the runtime .dll.
On macOS, use libSoundTeG_Ambisonic_Decoder.dylib in the matching macOS platform/configuration bin folder under the Unreal Wwise integration’s ThirdParty directory. Keep the .dylib extension for Unreal; the .bundle rename above applies to Unity. Folder names depend on the integration version. Restart Unreal after copying the library.
The sound becomes silent
If the sound becomes silent, first check the Audio Bus containing SoundTeG Ambisonic Decoder: Bus Configuration must be set to Ambisonics. The decoder works only on an ambisonic bus. If an individual speaker channel is silent, check its Phantom setting; phantom channels are intentionally silent. Also check the sound’s Output Bus, the decoder layout, and the hardware output routing.
The RTPC helper cannot connect
Keep Wwise open, enable WAAPI, and check the HTTP port in User Preferences. If the helper cannot identify a decoder instance, select its bus in Wwise and try again.
For further help, contact Support with your Wwise version, plug-in version, operating system, audio device, speaker layout, and a description of the result.
Demo: My World
My World demonstrates the SoundTeG plug-ins in Unity and Wwise. Visit the Demo page to download the Windows, macOS, and Android applications.
