Cria um objeto de áudio não posicional ( global ).
Utiliza a [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API].
// create an AudioListener and add it to the camera
const listener = new THREE.AudioListener();
camera.add( listener );
// create a global audio source
const sound = new THREE.Audio( listener );
// load a sound and set it as the Audio object's buffer
const audioLoader = new THREE.AudioLoader();
audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
sound.setBuffer( buffer );
sound.setLoop( true );
sound.setVolume( 0.5 );
sound.play();
});
[example:webaudio_sandbox webaudio / sandbox ]
[example:webaudio_visualizer webaudio / visualizer ]
listener — (obrigatório) instância [page:AudioListener AudioListener].
Se deve iniciar a reprodução automaticamente. O padrão é `false`.
O [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] do [page:AudioListener listener] dado no construtor.
Modifica o tom, medido em centenas. +/- 100 é um semitom. +/- 1200 é uma oitava. O padrão é `0`.
Representa um array de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioNode AudioNodes]. Pode ser usado para aplicar uma variedade de filtros de baixa ordem para criar efeitos sonoros mais complexos. Na maioria dos casos, o array contém instâncias de [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]. Filtros são definidos por [page:Audio.setFilter] ou [page:Audio.setFilters].
Um [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] criado usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().
Se a reprodução pode ser controlada usando os métodos [page:Audio.play play](), [page:Audio.pause pause]() etc. O padrão é `true`.
Se o áudio está sendo reproduzido no momento.
Uma referência ao objeto ouvinte (listener) deste áudio.
Velocidade de reprodução. O padrão é `1`.
Um deslocamento para o tempo dentro do buffer de áudio em que a reprodução deve começar. Igual ao parâmetro `offset` do [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). O padrão é `0`.
Substitui a duração do áudio. O mesmo que o parâmetro `duration` do [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). O padrão é `undefined` para reproduzir todo o buffer.
Um [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] criado usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().
Tipo da fonte de áudio. O padrão é a string 'empty'.
String que denota o tipo, definido como 'Audio'.
Conecta-se ao [page:Audio.source]. Isso é usado internamente na inicialização e quando configurar / remover filtros.
Desconecta-se do [page:Audio.source]. Isso é usado internamente quando configurar / remover filtros.
Retorna a desafinação da oscilação em centenas.
Retorna o primeiro elemento do array [page:Audio.filters filters].
Retorna o array [page:Audio.filters filters].
Retorna o valor do [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] (se a reprodução deve fazer um loop).
Retorna o [page:Audio.gain gainNode].
Retorna o valor do [page:Audio.playbackRate playbackRate].
Retorna o volume atual.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] é true, começa a reprodução.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] é true, pausa a reprodução.
Chamado automaticamente quando a reprodução termina.
Configura a [page:Audio.source source] para o audioBuffer e define [page:Audio.sourceType sourceType] para 'buffer'.
Se [page:Audio.autoplay autoplay], também inicia a reprodução.
Define a desafinação da oscilação em centenas.
Aplica um único nó de filtro ao áudio.
value -array de filtros.
Aplica um array de nós de filtro ao áudio.
Configura [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] para `value` (se a reprodução deve fazer um loop).
Configura [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] para `value`.
Configura [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] para `value`.
Aplica o objeto dado do tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement] como a fonte deste áudio.
Também define [page:Audio.hasPlaybackControl hasPlaybackControl] para false.
Aplica o objeto dado do tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream] como a fonte deste áudio.
Também define [page:Audio.hasPlaybackControl hasPlaybackControl] para false.
Configura o [page:Audio.source source] para o audioBuffer e define [page:Audio.sourceType sourceType] para 'audioNode'.
Também define [page:Audio.hasPlaybackControl hasPlaybackControl] para false.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] está ativado, configura o [page:Audio.playbackRate playbackRate] para `value`.
Configura o volume.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] está ativado, para a reprodução.
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]