SetSoundPaused: Difference between revisions

Revision as of 22:46, 4 May 2013

This function is used to either pause or unpause the playback of the specified sound element. Use a player element to control a players voice with this function.

Syntax

bool setSoundPaused ( element theSound, bool paused )

Required Arguments

theSound: The sound element which you want to pause/unpause.
paused: A boolean value representing whether the sound should be paused or not. To pause the sound, use true.

Returns

Returns true if the sound element was successfully paused, false otherwise.

Example

This example will allow the user to toggle sounds from paused to playing, and from playing to paused

Click to collapse [-]

Client

theSound = playSound("music/song.mp3", true)
function togglePausedSound()
    if(isSoundPaused(theSound)) then --sound is paused, un-pause it
        setSoundPaused(theSound, false)
    else --sound is not paused, pause it
        setSoundPaused(theSound, true)
    end
end
addCommandHandler("pausesound", togglePausedSound)

Changelog

Version	Description

1.3.2

Added player element for voice control

@@ Line 2: / Line 2: @@
 {{Client function}}
 This function is used to either pause or unpause the playback of the specified [[sound]] element.
+{{New_feature|3.0139|1.3.2|
+Use a player element to control a players voice with this function.
+}}
 ==Syntax==
 <syntaxhighlight lang="lua">bool setSoundPaused ( element theSound, bool paused )</syntaxhighlight>
@@ Line 28: / Line 30: @@
 </syntaxhighlight>
 </section>
+==Changelog==
+{{ChangelogHeader}}
+{{ChangelogItem|1.3.2|Added player element for voice control}}
 ==See Also==
 {{Client_audio_functions}}