View source for PT-BR/getSoundLength

__NOTOC__ 
{{BR/Funcao cliente}}

Essa função é usada para obter o duração da reprodução de um elemento de [[sound|áudio]] em segundos.
{{New feature/item|3.0132|1.3.2||
Se o elemento no primeiro argumento for um jogador, essa função usará sua voz.
}}

==Sintaxe== 
<syntaxhighlight lang="lua">float getSoundLength ( element audio )</syntaxhighlight> 

{{BR/OOP||[[sound|audio]]:getLength|length}}

===Argumentos necessários=== 
*'''audio:''' o elemento de [[sound|áudio]] ao qual você deseja obter a duração da reprodução.

===Retorno===
Retorna um [[float]] indicando a duração em segundos de um elemento de [[sound|áudio]].

==Exemplo==
Reproduz o som e então exibe sua duração.
<syntaxhighlight lang="lua">
local audio = playSound("money.mp3", false) -- Reproduz um áudio
local duracao = getSoundLength(audio) -- Obtém a duração de 'audio'
outputChatBox("Esse áudio tem a duração de " .. duracao .. " segundos.")
</syntaxhighlight>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}

==Veja também==
{{Client_audio_functions}}

[[en:getSoundLength]]
[[hu:getSoundLength]]
[[ar:getSoundLength]]
[[ro:getSoundLength]]