OnClientWorldSound: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 2: | Line 2: | ||
{{Client event}} | {{Client event}} | ||
This event is triggered whenever a world sound is played. A world sound is a sound effect which has not been caused by [[playSound]] or [[playSound3D]]. | This event is triggered whenever a world sound is played. A world sound is a sound effect which has '''''not''''' been caused by [[playSound]] or [[playSound3D]]. | ||
''Note: onClientWorldSound should only be used to stop world sounds from playing. To replace a world sound with a custom sound, it is suggested that you detect when to play the replacement by other means.'' | ''Note: onClientWorldSound should only be used to stop world sounds from playing. To replace a world sound with a custom sound, it is suggested that you detect when to play the replacement by other means.'' |
Revision as of 17:57, 13 May 2012
This event is triggered whenever a world sound is played. A world sound is a sound effect which has not been caused by playSound or playSound3D.
Note: onClientWorldSound should only be used to stop world sounds from playing. To replace a world sound with a custom sound, it is suggested that you detect when to play the replacement by other means.
Parameters
int group, int index
- group: An integer representing the world sound group
- index: An integer representing an individual sound within the group
Source
The source of this event is the root element
Cancel effect
If this event is canceled, then the sound will not be played.
Example
This example prints the world sound group and index in the chat box, and stops all world sound effects in group 5
function handleOnClientWorldSound( group, index ) outputChatBox( "World sound group:" .. group .. ", index:" .. index ) if group == 5 then cancelEvent() -- Don't play this end end addEventHandler ( "onClientWorldSound", getRootElement(), handleOnClientWorldSound)
Requirements
This template will be deleted.
See Also
Client sound events
- onClientSoundBeat
- onClientSoundChangedMeta
- onClientSoundFinishedDownload
- onClientSoundStarted
- onClientSoundStopped
- onClientSoundStream