playSound

Cliente Som OOP Sound.create(...)Sound(...)

Toca um arquivo de áudio do resource ou uma URL de streaming, sem posição no mundo.

Sintaxe

element playSound ( string caminho [, bool loop = false, bool limitarDownload = true ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
`caminho`	string	—	Caminho de um arquivo deste resource (ou `:outroResource/arquivo`), uma URL começando com `http` ou `ftp`, ou os próprios dados de áudio — uma string que não é um caminho de arquivo válido é tocada como bytes de áudio brutos.
`loop`	bool	`false`	Com `true`, o som recomeça sozinho ao terminar.
`limitarDownload`	bool	`true`	Só vale para URLs: baixa os dados no ritmo da reprodução em vez de o mais rápido possível.

Retorno

O elemento de som criado, ou false se o áudio não puder ser aberto. Um arquivo não encontrado também registra um aviso; um caminho :outroResource/ para um resource que não está rodando devolve false em silêncio.

Exemplo

local aviso = playSound("sons/aviso.wav")
setSoundVolume(aviso, 0.6)

-- uma rádio na internet, tocando continuamente
local radio = playSound("https://exemplo.com/stream.mp3", true)

Veja também

playSFX — Toca um som dos bancos de áudio do jogo.
getSFXStatus — Verifica se um container de áudio do jogo está utilizável.
stopSound — Para um som e destrói o elemento correspondente.