OnClientWorldSound: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{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]...")
 
No edit summary
Line 3: Line 3:


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.''


==Parameters==
==Parameters==

Revision as of 13:06, 10 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