Skip to content

Audio

Audio and images can be used in your project to make it more immersive.

For a quick guide for adding audio see the quick start guide

Audio

To use audio files in your project they first need to be uploaded to the media library.

To upload your audio files:

  1. Click on the Media tab.
  2. Press Upload media and drag and drop your audio files into the editor. The files will begin uploading.
  3. Go back to the Media tab by clicking the back button.

upload_files

Supported Formats

Fabella supports audio playback of various formats such as Ogg Vorbis, WAV and MP3, both compressed and uncompressed. Keep in mind that file size can affect the time it takes for the devices to respond in runtime.

Audio tags

To play audio clips within a project, use the audio tag “sfx”. You can also use the audio tag “stop” to instantly stop a playing audio clip, or “stopall” to stop all playing audio clips.

%(sfx:fanfare)%

%(stop:fanfare)%

%(stopall)%

Audio tags can be written out directly in Say nodes, and they can be used in Say-, Resume- and Repeat fields.

trumpet

Using the random node, you can randomize the order audio clips are played in. Start by giving the audio clips identical names with a descending number at the end. For example: sound-1, sound-2, sound-3, etc.

Then use the random node to generate a random number equal to the amount of audio clips you want randomized and assign it to a variable. When you use the variable in the audio tag, a random sound will be picked.

%(sfx:sound-{result})%

Making music loop

If you start the music clip with %(sfx:bg_music)% and then in a later node (but before the hear node) stop the music %(stop:bg_music)% the clip is looped for the entire duration between the sfx and stop-tag

Syntax

The syntax for including audio clips in say-nodes is the following.

%(tag:name, property1=x, property2=x, property3=x)%

The properties can be chosen from this list:

Property Name Description Syntax
Volume The volume of the audio clip %(sfx:MySound,v=0.5)%
Fade In The fade-in time of the audio clip %(sfx:MySound,fi=2)%
Fade Out The fade-out time of the audio clip %(sfx:MySound,fo=2)%