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.

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.

In the Audiokinetic Launcher Plug-ins page, choose Add from archive.
Choose Add from archive on the Launcher’s Plug-ins page.

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.

Select the downloaded SoundTeG plug-in ZIP file, then click Open.
Select SoundTeG_Ambisonic_Decoder.zip.

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.

Confirm SoundTeG Ambisonic Decoder and the matching Wwise version, then apply the installation.
Confirm SoundTeG Ambisonic Decoder and the Wwise version, then click Install or Modify.

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.

Import the SoundTeG Ambisonic Decoder factory presets when creating a project.
Import the SoundTeG Ambisonic Decoder factory presets when creating a project.

3. Create an ambisonic bus

Under Main Audio Bus, create a child Audio Bus. The example names this bus SFX_5OA.

Create an Audio Bus under Main Audio Bus.
Create an Audio Bus under Main Audio Bus.

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

Choose an ambisonic bus configuration. This example uses fifth-order ambisonics.
Choose an ambisonic bus configuration. This example uses fifth-order ambisonics.

4. Add SoundTeG Ambisonic Decoder

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

Add SoundTeG Ambisonic Decoder on the bus’s Effects tab.
Add SoundTeG Ambisonic Decoder on the bus’s Effects tab.

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

Open the decoder interface; select a property to read its Contextual Help.
Open the decoder interface; select a property to read its Contextual Help.

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.

Choose a loudspeaker-layout preset from the preset menu.
Choose a loudspeaker-layout preset from the preset menu.

6. Create and position a test sound

Create a Sine source under a Contents Work Unit for the playback test.

Create a Sine source for a playback test.
Create a Sine source for a 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.

Enable Listener Relative Routing and set 3D Spatialization to Position + Orientation.
Enable Listener Relative Routing and set 3D Spatialization to Position + Orientation.

7. Route the sound to the ambisonic bus

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

Route the test sound to the ambisonic bus.
Route the test sound to the ambisonic bus.

8. Monitor the decoded output

Select the ambisonic bus in the Meter view.

Select the ambisonic bus in the Meter view.
Select the ambisonic bus in the Meter view.

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

Play the sound and inspect the decoded output with your configured speaker layout.
Play the sound and inspect the decoded output with your configured speaker 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.

Create a SoundTeG Multichannel Output Audio Device when using multichannel hardware.
Create a SoundTeG Multichannel Output Audio Device when using multichannel hardware.

Plug-in properties

PropertyDescription
OutputsThe total number of speaker outputs calculated by the decoder. Range: 2–36 outputs.
Decode MethodThe method used to convert the ambisonic input into audio for the selected loudspeaker layout. See the method table below.
Apply MaxREApplies 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

ValueMethod
1 — SADSampling Ambisonic Decoder
2 — MMDMode Matching Decoder
3 — EPADEnergy-Preserving Ambisonic Decoder
4 — ALLRADAll-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.

PropertyDescription
AzimuthDefines the horizontal angle of the speaker.
ElevationDefines the vertical angle of the speaker.
PhantomMarks 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.

Use the RTPC tab to bind decoder properties to Game Parameters.
Use the RTPC tab to bind decoder properties to Game Parameters.

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

  1. Keep the Wwise project open and enable WAAPI in Wwise User Preferences. The helper uses the local HTTP port 8090 by default.
  2. Select the bus containing the decoder instance you want to configure. If several instances exist, work on one instance at a time.
  3. Open a command prompt. Replace the example path below with the location where you saved the script.
  4. 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.

Run the optional decoder RTPC helper from a command prompt.
Run the optional decoder RTPC helper from a command prompt.
The helper reports the created Game Parameters and verified RTPC bindings.
The helper reports the created Game Parameters and verified RTPC bindings.

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.