User Tools

Site Tools


play_sound

Play Sound


Plays the specified sound effect. If the optional loop argument is set to true, the sound effect will continue to play at the given interval of time (e.g. once per second) until stopped via the Stop Sound function.

Signature:

play_sound(sound_name, loop, interval)
ArgumentDescriptionTypeRequired
sound_nameName of the sound effect to play.StringYes
loopWhether or not the sound effect will loop or play only once. When true, it will loop until stopped via the Stop Sound function.BooleanNo
intervalInterval of time in seconds to wait between each playing of the sound effect (only applicable when the loop argument is true).NumberNo
Return ValueDescriptionType
Sound IDReturns a unique numeric ID that can be stored for later reference (e.g. to stop a looping sound via the Stop Sound function).Number

The built-in Sound FX Generator, accessed from the main toolbar along the top of the application, can be used to generate some basic 8-bit style sound effects.

Example:

play_sound("alarm.wav", true, 1);

Results: Plays the sound effect named “alarm.wav” once every second until stopped.

Use the Play Sound function to trigger a sound effect when the player opens a door or a treasure chest, or an event occurs that you'd like the player to hear regardless of their location.


Editor Node:

play_sound.txt · Last modified: 2024/01/31 22:20 by justin