PlayAllSounds | Vanda Engine

Definition

PlayAllSounds([optional] string exception_1, [optional] string exception_2,..., [optional] string exception_n)

Description

This function plays all ambient, 3D and resource sounds except for the ambient, 3D and resource sounds sent to the function. If the loop state of each sound is true, the sound will be played continuously, otherwise it will be played only once.

Parameters

[optional] string exception_1, [optional] string exception_2,…, [optional] string exception_n

Specifies the name of the ambient, 3D and resource sounds that should not be played by this function. If no name is passed to PlayAllSounds function, all sounds will be played.

Example

function OnTriggerEnter(otherActorName)
    --nil means main character controller
    if otherActorName == nil then
          LoadResource("Sounds", "fire.ogg")
          LoadResource("Sounds", "river.ogg")
          LoadResource("Sounds", "ambient.ogg")
    end
end

function OnTriggerStay(otherActorName)

end

function OnTriggerExit(otherActorName)
    if otherActorName == nil then
          PlayAllSounds("ambient2", "river3D_2", "Sounds_fire.ogg", "Sounds_river.ogg")
    end
end

Assume that the above script is attached to a trigger named trigger1. Also assume that “ambient2” and “river_3D2” are ambient and 3D sound names, respectively.

Whenever the main character enters “trigger1”, we load 3 resource sounds — In order for LoadResource function to load the desired resource, you must first add it through the Add Resource to Current Project dialog (File > Project > Add/Remove Resource to/from Current Project). When the main character exits “trigger1”, all the sounds except the ambient sound “ambient2”, 3D sound “river_3D2” and resource sounds “fire.ogg” and “river.ogg” will be played.