PT-BR/playSFX3D

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Essa função reproduz no mundo um áudio padrão do GTA.


[[{{{image}}}|link=|]] Note: Existe uma ferramenta que te permite encontrar as categorias e os IDs dos áudios facilmente: [sfxBrowser:Download].
Dialog-warning.png 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.

Sintaxe

element playSFX3D ( string categoria, int idGrupo, int idAudio, float x, float y, float z [, bool repetir = false ] )

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

NOTA: Ao usar argumentos opcionais, pode ser necessário fornecer todos os argumentos anteriores ao que você deseja usar. Para obter mais informações sobre argumentos opcionais, consulte Argumentos Opcionais.

  • repetir: Um boolean representando se o áudio deverá se repetir.

Retorno

Retorna um elemento de áudio se bem sucedido, do contrário retorna false.

Sintaxe 2

element playSFX3D( string "radio", string estacao, int idMusica, float x, float y, float z [, bool repetir = false ] )

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

NOTA: Ao usar argumentos opcionais, pode ser necessário fornecer todos os argumentos anteriores ao que você deseja usar. Para obter mais informações sobre argumentos opcionais, consulte Argumentos Opcionais.

  • repetir: Um boolean representando se o áudio deverá se repetir.

Retorno

Retorna um elemento de áudio se bem sucedido, do contrário retorna false.

Exemplo

Este exemplo reproduz repetidamente próximo à você um áudio de alarme de incêndio.

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

Veja também