PT-BR/playSFX

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

Essa função reproduz 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 playSFX ( string categoria, int idGrupo, int idAudio [, 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.

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 playSFX ( string "radio", string estacao, int idMusica [, bool repetir = false ] )

Argumentos necessários

  • 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.

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

Esse exemplo reproduz repetidamente um áudio de alarme de incêndio.

if not playSFX("script", 7, 1, true) then
    outputChatBox("Você precisa instalar alguns arquivos de áudio ausentes")
end

Veja também