audio_group_unload

This function will unload all the sounds that are flagged as belonging to the given Audio Group.

The function will return true if unloading is initiated and false if the group ID is invalid, or it has already been flagged for unloading.

NOTE Any audio currently being played when this function is called will be stopped.

 

Syntax:

audio_group_unload(groupID);

ArgumentTypeDescription
groupIDAudio Group IDThe index of the audio group to unload (as defined in the Audio Groups window)

 

Returns:

Boolean

 

Example:

if (audio_group_is_loaded(audiogroup_level1))
{
    audio_group_unload(audiogroup_level1);
}

The above code checks to see if an audio group has been loaded and if it has it unloads it.