PlayAllStopped3DSounds | Vanda Engine

Definition

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

Description

This function plays all stopped 3D sounds except for the stopped 3D sounds sent to the function. If the loop state of each 3D sound is true, the stopped 3D 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 stopped 3D sounds that should not be played by this function. If no name is passed to PlayAllStopped3DSounds function, all stopped 3D sounds will be played.

Example

function OnTriggerEnter(otherActorName)
    --nil means main character controller
    if otherActorName == nil then
          StopAll3DSounds()
    end
end

function OnTriggerStay(otherActorName)

end

function OnTriggerExit(otherActorName)
    if otherActorName == nil then
          PlayAllStopped3DSounds("river2", "river3")
    end
end

Assume that the above script is attached to a trigger named trigger1. Also assume that “river2” and “river3” are 3D sound objects.

Whenever the main character enters “trigger1”, all the 3D sounds that are playing will be stopped. When the main character exits “trigger1”, all the stopped 3D sounds except the 3D sounds “river2” and “river3” will be played.