PT-BR/playSound: Difference between revisions

Latest revision as of 20:12, 1 April 2023

Cria um elemento de áudio e o reproduzir imediatamente para o jogador local.

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 playSound ( string caminho/data, [ bool repetir = false, bool suprimido = true ] )

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

Método: Sound(...)

Argumentos necessários

caminho: o caminho até o arquivo de áudio ou uma URL (http://, https:// or ftp://) para o arquivo de áudio. (Obs: Reproduzir arquivos de áudio de outros resources requer que eles estejam executando.)

ADDED/UPDATED IN VERSION 1.5.7 r20460:

data: pode ser o binário do arquivo de áudio.

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

Esse exemplo reproduz o arquivo audio.mp3.

Click to collapse [-]

Cliente

addCommandHandler("reproduzir", function()
    local audio = playSound("audio.mp3")
    setSoundVolume(audio, 0.3)
end)

Esse exemplo reproduz uma música da internet.