View source for PT-BR/playSound3D

__NOTOC__ 
{{BR/Funcao cliente}}
Cria um elemento de [[sound|áudio]] no mundo do GTA e o reproduz imediatamente para o [[player|jogador]] local. Você pode usar [[setElementPosition]] para mover elementos de [[sound|áudio]] já criados. Lembre-se de usar [[setElementDimension]] após a criação para reproduzir o áudio fora da dimensão 0.

{{Note|
* Os únicos formatos suportados são: MP3, WAV, OGG, RIFF, MOD, XM, IT, S3M e PLS (streams da web).
* Por questões de desempenho, quando usado para áudios que são reproduzidos com alta frequência (exemplo, som de tiro de armas), é recomendado que você converta o arquivo de áudio para apenas um canal (mono) WAV e com o bitrate de 22050 Hz ou menos. Além disso, considere adicionar um limite na frequência com que o áudio será reproduzido, por exemplo, apenas uma vez a cada 50ms.
}}

==Sintaxe==
<syntaxhighlight lang="lua">element playSound3D ( string caminho, float x, float y, float z, [ bool repetir = false ] )</syntaxhighlight> 
<syntaxhighlight lang="lua">element playSound3D ( string url, float x, float y, float z, [ bool repetir = false, bool suprimido = true ] )</syntaxhighlight> 
{{New items|5.0157|1.5.7|
<syntaxhighlight lang="lua">element playSound3D ( string binario, float x, float y, float z, [ bool repetir = false ] )</syntaxhighlight> 
|20460}}

{{BR/OOP||[[Sound|Sound3D]]}}

===Argumentos necessários===
*'''caminho:''' o [[filepath|caminho]] até o arquivo de áudio. ('''Obs:''' Reproduzir arquivos de áudio de outros resources requer que eles estejam executando).
*'''url:''' uma URL (http://, https:// or ftp://) para o arquivo de áudio. Nessa versão você não precisa predefinir o áudio no [[meta.xml]].
{{New items|5.0157|1.5.7|
*'''binario:''' o conteúdo binário do arquivo de áudio.
|20460}}
*'''x:''' um [[float]] representando a coordenada X no mapa.
*'''y:''' um [[float]] representando a coordenada Y no mapa.
*'''z:''' um [[float]] representando a coordenada Z no mapa.

===Argumentos opcionais=== 
{{BR/ArgOpcional}} 
*'''repetir:''' um [[boolean]] indicando se o áudio será repetido. A repetição de um áudio não está disponível para streams, apenas para arquivos de áudio locais.
{{New feature/item|3.0150|1.5||
*'''suprimido:''' um [[boolean]] representando se a largura de banda da stream será suprimida (isto é, velocidade de download reduzida). Streams serão suprimidas por padrão.
}}

===Retorno===
Retorna um elemento de [[sound|áudio]] se bem sucedido, do contrário retorna ''false''.

==Exemplo== 
Este exemplo reproduz repetidamente um áudio dentro da pizzaria em San Fierro próximo ao Pier 69.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
playSound3D("audio.mp3", 373.14, -125.21, 1001, true)
</syntaxhighlight>
</section>

Este exemplo reproduz um áudio da internet na Grove Street.
<section name="Example 2" class="client" show="true" >
<syntaxhighlight lang="lua">
playSound3D("https://tidis.net/mESK2U-0", 2498, -1659, 12)
</syntaxhighlight>
</section>

==Veja também==
{{PT-BR/Funcoes_audio_client}}
[[EN:playSound3D]]
[[HU:playSound3D]]
[[AR:playSound3D]]
[[DE:playSound3D]]
[[RU:playSound3D]]