Global Command: getSoundId

From The Official Visionaire Studio: Adventure Game Engine Wiki

Retrieve the id of a currently active audio file. Use the sound id to stop/pause/resume or edit the linked sound properties.

Related functions getSoundProperty | setSoundProperty | startSound | stopSound | toggleSoundPause


Syntax

getSoundId(soundfile)


Parameters

Parameter Type Description
soundfile string Relative path to the audio file whose id you want to obtain. Add the "vispath:" prefix.


Return values

Type Description
integer Unique id referencing the requested sound, or -1 if the sound is not active.


Examples

Example 1: Store the sound id into a variable for later use.

local mySoundId = getSoundId("vispath:sounds/example.ogg")