GetSoundPosition: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Reverted edits by Ameir (talk) to last revision by Alvesvin)
Tag: Rollback
 
(17 intermediate revisions by 13 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
Get sound position in the GTA world.
This function is used to return the current seek position of the specified [[sound]] element.
If the element is a player, this function will use the players voice.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">integer getSoundPosition ( string sound )</syntaxhighlight>  
<syntaxhighlight lang="lua">float getSoundPosition ( element theSound )</syntaxhighlight>  
 
{{OOP||[[sound]]:getPlaybackPosition|playbackPosition|setSoundPosition}}
===Required Arguments===  
===Required Arguments===  
*'''sound:''' Name of the sound.
*'''theSound:''' The [[sound]] element which seek position you want to return.


===Returns===
===Returns===
Returns an''integer''s indicating the position of the sound in mini seconds. (times by 1000 to get seconds)
Returns a [[float]] value indicating the seek position of the [[sound]] element in seconds.


==Example==  
==Example==  
TODO
Plays a sound then outputs the seek position.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--TODO
local sound = playSound("randomSound.mp3",false) --Play a sound
local soundPosition = getSoundPosition(sound) --Get the current sound position
outputChatBox("The current seek position of the sound is: " .. soundPosition .. ".")
</syntaxhighlight>
</syntaxhighlight>
</section>
 
==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}


==See Also==
==See Also==
{{audio functions}}
{{Client_audio_functions}}
 
[[hu:getSoundPosition]]
[[AR:getSoundPosition]]
[[RO:getSoundPosition]]
[[pt-br:getSoundPosition]]

Latest revision as of 16:36, 26 September 2021

This function is used to return the current seek position of the specified sound element. If the element is a player, this function will use the players voice.

Syntax

float getSoundPosition ( element theSound )

OOP Syntax Help! I don't understand this!

Method: sound:getPlaybackPosition(...)
Variable: .playbackPosition
Counterpart: setSoundPosition


Required Arguments

  • theSound: The sound element which seek position you want to return.

Returns

Returns a float value indicating the seek position of the sound element in seconds.

Example

Plays a sound then outputs the seek position.

local sound = playSound("randomSound.mp3",false) --Play a sound
local soundPosition = getSoundPosition(sound) --Get the current sound position
outputChatBox("The current seek position of the sound is: " .. soundPosition .. ".")

Changelog

Version Description
1.3.2 Added player element to use a players voice

See Also