playSound3D

Toca um arquivo de áudio do resource ou uma URL de streaming num ponto fixo do mundo.

Sintaxe

element playSound3D ( string caminho, number x, number y, number z
                      [, 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.
x, y, z	number	—	Posição do som no mundo.
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.

Nota

Um som 3D só é aberto quando a câmera entra na distância máxima dele, e é fechado de novo 40 unidades além dela ou enquanto o jogador local está numa dimensão diferente da do som; enquanto fechado, a posição de reprodução continua avançando. Áudio que não pode ser decodificado só é percebido nesse momento, não nesta chamada.

Exemplo

-- uma jukebox tocando no canto do bar
local jukebox = playSound3D("sons/blues.mp3", 1481.0, -1770.0, 18.8, true)
setSoundMinDistance(jukebox, 3)
setSoundMaxDistance(jukebox, 25)

Veja também

• playSFX3D — Toca um som dos bancos de áudio do jogo num ponto fixo do mundo.
• setSoundMinDistance — Define o raio dentro do qual um som 3D toca no volume cheio.
• getSoundMinDistance — Devolve o raio de volume cheio de um som 3D.
• setSoundMaxDistance — Define a distância a partir da qual um som 3D deixa de ser ouvido.
• getSoundMaxDistance — Devolve a distância de corte de um som 3D.
• setSoundPanningEnabled — Liga ou desliga o posicionamento estéreo automático de um som 3D.
• isSoundPanningEnabled — Verifica se o posicionamento estéreo automático está ligado.