Skip to content

Audio page

On the audio page, you can import audio files (prepared according to the guidelines) and set up behaviours that define how each object should be allocated to devices.

Each sequence has its own set of audio files and behaviours. Switch between sequences by clicking the tabs (which are labelled with your sequence names).

Adding and replacing audio files

To add an initial set of audio files, just click the "Add audio files" button. Find the files you want to add, select them, then press "Open". You'll see the audio files appear as rows in a table, with various options which are explained below.

You can delete single or multiple files by selecting the checkboxes for the files you'd like to delete, then pressing the delete button at the top right of the table.

You can also replace the full set of audio files by clicking "Replace all audio files".


When replacing audio files, if you select fewer new files than are already loaded, then any missing files will show errors ("No audio file matches the object number"). You'll need to manually delete these objects. It is only possible to import full sets of files.


If you have any sequences with no audio files, you will not be able to preview or export the experience. There will be an error message on the Export page ("No audio files have been added").

The audio object table

Once you've imported your files, they'll appear as rows of the audio object table. In each row, you'll see a checkbox, the filename, a panning setting, two fixed behaviours, and an "Add behaviour" button. These are detailed below. Any behaviours that you've added will also be shown in the table row.


The current panning value for each object is shown in the object table row.

To change the panning, just click the current value, which will reveal a slider. You can either adjust the panning using the slider, or click the "L", "R", or "C" buttons for 100% left, 100% right, or centre panning respectively.

The panning cannot be changed for stereo objects.


See the Preparing audio assets page for information on automatic panning based on the filename.


Panning is implemented by a Web Audio API StereoPannerNode for browsers in which this is supported, and by other Web Audio API components that mimic the behaviour where the StereoPannerNode is not supported.


Behaviours determine how each object should be allocated to devices. This lets you customise the listener experience, ensuring that it is flexible and can adapt to the number of connected devices and to settings that listeners make using controls.

There are four types of behaviour.

  • Fixed behaviours are always included for every object. They define the device roles and number of devices that objects can be allocated to. Fixed behaviours are shown as dropdown lists in the audio object table.
  • Control-linked behaviours are linked to any controls that you've set up.
  • Custom behaviours give you more flexibility in deciding how the objects should be allocated.
  • The Image and effects behaviour allows you to add timed images and effects, attached to audio objects, to the experience.

The four behaviour types are described in more detail in the linked documentation pages.

Add behaviour button

The "Add behaviour" button is used to add control-linked behaviours or custom behaviours to the objects. Clicking the button will reveal a dropdown list containing the behaviour options. Click the option you need to apply it to the object.

  • The control-linked behaviours (which relate to any controls that you have set up) appear at the top of the list with orange dots. You can only add one instance of each control-linked behaviour to each object. See Control-linked behaviours for more details.

  • The custom behaviours appear after the control-linked behaviours. There are six custom behaviour types (Preferred if, Allowed if, Prohibited if, Exclusive, Change management, and Mute if), each with a different colour dot. See Custom behaviours for more details.

  • The Images and effects behaviour appears after the custom behaviours. See Images and effects behaviour for more details.

When you add a behaviour to an object, it will appear as a coloured box in the object's row of the audio object table.

Editing and deleting behaviours

Behaviours that have editable parameters (all control-linked behaviours, most custom behaviours, and the image and effects behaviour) will show an "editable" icon. Clicking on the behaviour will open its settings.

All control-linked behaviours, custom behaviours, and the image and effects behaviour) have a delete button ("X" icon) on the right hand side (you'll be asked to confirm that you want to delete the behaviour).

Adding the same behaviour to multiple objects

The same behaviour can be added to multiple objects in one go. Select all of the objects to which you want to add the behaviour (using the checkboxes on the left hand side of the object table), then click the "Add behaviour" button (either above the audio object table, or on any of the selected objects).