audio_exists

This function returns whether a Sound Asset exists.

The sound to check can either be a single instance of a sound (the index for individual sounds being played can be stored in a variable when using the audio_play_sound or audio_play_sound_at functions) or a sound asset.

NOTE If the index you search for has not been initialised previously, this function will cause an error as it is searching for non-existent asset indices.

 

Syntax:

audio_exists(index);

ArgumentTypeDescription
indexSound AssetThe index of the sound to check the existence of.

 

Returns:

Boolean

 

Example:

if audio_exists(global.Music)
{
    audio_play_sound(global.Music, 0, true);
}

The above code checks to see if a sound exists. If it does it is set to play in a loop.