PT-BR/playSound3D

From Multi Theft Auto: Wiki
Revision as of 22:09, 18 August 2021 by Alvesvin (talk | contribs) (Created page with "__NOTOC__ {{BR/Funcao cliente}} Cria um elemento de áudio no mundo do GTA e o reproduz imediatamente para o jogador local. Você pode usar setElementP...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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


[[{{{image}}}|link=|]] 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

element playSound3D ( string caminho, float x, float y, float z, [ bool repetir = false ] )
element playSound3D ( string url, float x, float y, float z, [ bool repetir = false, bool suprimido = true ] )
ADDED/UPDATED IN VERSION 1.5.7 r20460:
element playSound3D ( string binario, float x, float y, float z, [ bool repetir = false ] )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: Sound3D(...)

Argumentos necessários

  • caminho: o 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.
ADDED/UPDATED IN VERSION 1.5.7 r20460:
  • binario: o conteúdo binário do arquivo de áudio.
  • 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

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

Click to collapse [-]
Example
playSound3D("audio.mp3", 373.14, -125.21, 1001, true)

Este exemplo reproduz um áudio da internet na Grove Street.

Click to collapse [-]
Example 2
playSound3D("https://tidis.net/mESK2U-0", 2498, -1659, 12)

Veja também