LordHenry at 20:11, 1 April 2023

2023-04-01T20:11:58Z

← Older revision		Revision as of 20:11, 1 April 2023
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{BR/~~Funcao cliente~~}}		{{PT-BR/Client_function}}
	{{New feature/item\|3.0134\|1.3.4\|5731\|		{{New feature/item\|3.0134\|1.3.4\|5731\|
	Essa função reproduz no mundo um áudio padrão do GTA.		Essa função reproduz no mundo um áudio padrão do GTA.

Alvesvin: Created page with "NOTOC {{BR/Funcao cliente}} {{New feature/item|3.0134|1.3.4|5731| Essa função reproduz no mundo um áudio padrão do GTA. }} {{Note|Existe uma ferramenta que te permit..."

2021-08-18T01:32:57Z

Created page with "__NOTOC__ {{BR/Funcao cliente}} {{New feature/item|3.0134|1.3.4|5731| Essa função reproduz no mundo um áudio padrão do GTA. }} {{Note|Existe uma ferramenta que te permit..."

New page

__NOTOC__
{{BR/Funcao cliente}}
{{New feature/item|3.0134|1.3.4|5731|
Essa função reproduz no mundo um áudio padrão do GTA.
}}

{{Note|Existe uma ferramenta que te permite encontrar as categorias e os IDs dos áudios facilmente: [[https://community.mtasa.com/index.php?p=resources&s=details&id=7549 sfxBrowser:Download]].}}
{{Aviso|Muitos jogadores usam versões do GTA:SA (especialmente versões pirateadas) ao qual possuem arquivos de áudio preenchidos com zeros para melhorar a compressão da pasta ''AUDIO\SFX\'' (eles estão corrompidos). No caso desses arquivos de áudio inválidos, essa função retorna ''false''. A função também retorna ''false'' ao tentar reproduzir um áudio removido de versões recentes do GTA:SA baixado na Steam.|true}}

==Sintaxe==
<syntaxhighlight lang="lua">
element playSFX3D ( string categoria, int idGrupo, int idAudio, float x, float y, float z [, bool repetir = false ] )
</syntaxhighlight>

===Argumentos necessários===
*'''categoria:''' O nome de uma categoria de efeitos sonoros. Valores possíveis são: "feet", "genrl", "pain_a", "script", "spc_ea", "spc_fa", "spc_ga", spc_na", "spc_pa".
*'''idGrupo:''' O ID de um grupo de áudio.
*'''idAudio:''' O ID de um áudio dentro do grupo de áudios.
*'''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 opicionais===
{{BR/ArgOpcional}}
*'''repetir:''' Um [[boolean]] representando se o áudio deverá se repetir.

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

{{New feature/item|3.0140|1.4|6443|
==Sintaxe 2==
<syntaxhighlight lang="lua">
element playSFX3D( string "radio", string estacao, int idMusica, float x, float y, float z [, bool repetir = false ] )
</syntaxhighlight>

===Required Arguments===
*'''radio:''' A string "radio" (usada para diferenciar da primeira sintaxe).
*'''estacao:''' A estação de rádio. Valores possíveis são: "Adverts", "Ambience", "Police", "Playback FM", "K-Rose", "K-DST", "Cutscene", "Beats", "Bounce FM", "SF-UR", "Radio Los Santos", "Radio X", "CSR 103.9", "K-Jah West", "Master Sounds 98.3", "WCTR".
*'''idMusica:''' O ID da música pertencente à estação de rádio.
*'''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 opicionais===
{{BR/ArgOpcional}}
*'''repetir:''' Um [[boolean]] representando se o áudio deverá se repetir.

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

==Exemplo==

Este exemplo reproduz repetidamente próximo à você um áudio de alarme de incêndio.
<syntaxhighlight lang="lua">
local x, y, z = getElementPosition(localPlayer)
if not playSFX3D("script", 7, 1, x + 10, y, z, true) then
outputChatBox("Você precisa instalar alguns arquivos de áudio ausentes")
end
</syntaxhighlight>

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

[[en:playSFX3D]]
[[hu:playSFX3D]]

PT-BR/playSFX3D - Revision history

LordHenry at 20:11, 1 April 2023

Alvesvin: Created page with "__NOTOC__ {{BR/Funcao cliente}} {{New feature/item|3.0134|1.3.4|5731| Essa função reproduz no mundo um áudio padrão do GTA. }} {{Note|Existe uma ferramenta que te permit..."

Alvesvin: Created page with "NOTOC {{BR/Funcao cliente}} {{New feature/item|3.0134|1.3.4|5731| Essa função reproduz no mundo um áudio padrão do GTA. }} {{Note|Existe uma ferramenta que te permit..."