View source for PT-BR/getSoundLevelData

__NOTOC__
{{PT-BR/Client_function}}
Essa função obtém os níveis do lado esquerdo e direito de um elemento de [[sound|áudio]].
{{New feature/item|3.0132|1.3.2||
Se o elemento passado no primeiro argumento for um player, então essa função usará sua voz.
}}

==Sintaxe== 
<syntaxhighlight lang="lua">int, int getSoundLevelData ( element audio )</syntaxhighlight> 

{{BR/OOP||[[sound|audio]]:getLevelData}}

===Argumentos necessários=== 
* '''audio:''' o element de [[sound|áudio]] ao qual você deseja obter os dados de níveis.

===Retorno===
Retorna dois [[integer|inteiros]] de 0 a 32768.

==Exemplo==
<syntaxhighlight lang="lua">
local audio = playSound ( "sound.wav" )

function onSoundPlayRender ( )
    if ( audio ) then
        local nivelEsquerdo, nivelDireito = getSoundLevelData ( audio )
	if ( nivelEsquerdo ) then
            dxDrawRectangle ( 0, 0, 64, nivelEsquerdo / 32768 * 256, tocolor ( 255, 0, 0 ) )
            dxDrawRectangle ( 64, 0, 64, nivelDireito / 32768 * 256, tocolor ( 0, 0, 255 ) )
        end
    end
end
addEventHandler ( "onClientRender", root, onSoundPlayRender )
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3.0-9.04162|}}

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

==Veja também==
{{PT-BR/Funcoes_audio_client}}

[[en:getSoundLevelData]]
[[hu:getSoundLevelData]]
[[ar:getSoundLevelData]]
[[ro:getSoundLevelData]]