Crea un oggetto audio non posizionale (globale).
Utilizza le [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API API Web Audio].
// crea un AudioListener e aggiungilo alla camera
const listener = new THREE.AudioListener();
camera.add( listener );
// crea una sorgente audio globale
const sound = new THREE.Audio( listener );
// carica un suono e impostalo come buffer dell'oggetto audio
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 — (obbligatorio) istanza [page:AudioListener AudioListener].
Indica se avviare la riproduzione automaticamente. Il valore predefinito è `false`.
L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] del [page:AudioListener listener] passato nel costruttore.
Modifica l'intonazione, misurata in centesimi. +/- 100 è un semitono. +/- 1200 è un'ottava. Il valore predefinito è `0`.
Rappresenta un'array di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioNode AudioNode]. Può essere usato per applicare una varietà di filtri low-order per creare effetti sonori più complessi. In molti casi, l'array contiene istanze di [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNode]. I filtri sono impostati tramite [page:Audio.setFilter] o [page:Audio.setFilters].
Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] creato usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().
Indica se la riproduzione può essere controllata usando i metodi [page:Audio.play play](), [page:Audio.pause pause]() etc. Il valore di default è `true`.
Indica se l'audio è attualmente in riproduzione.
Un riferimento all'oggetto listener di questo audio.
Velocità di riproduzione. Il valore predefinito è `1`.
Un offset al momento in cui deve iniziare la riproduzione all'interno del buffer audio. È uguale al parametro audio di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). Il valore predefinito è `0`.
Sovrascrive la durata dell'audio. È uguale al parametro `duration` di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). Il valore predefinito è `undefined` per riprodurre l'intero buffer.
Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] creato usando [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().
Il tipo di sorgente audio. Il valore predefinito è la stringa 'empty'.
Stringa che denota il tipo, impostato ad 'Audio'.
Permette di collegarsi all'[page:Audio.source]. Questo metodo viene utilizzato internamente durante l'inizializzazione e durante l'impostazione/eliminazione dei filtri.
Permette di scollegarsi dall'[page:Audio.source]. Questo metodo viene utilizzato internamente durante l'impostazione/eliminazione dei filtri.
Restituisce il detuning dell'oscillazione in centesimi.
Restituisce il primo elemento dell'array [page:Audio.filters filters].
Restituisce l'array [page:Audio.filters filters].
Restituisce il valore di [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] (se la riproduzione deve essere ripetuta).
Restituisce il [page:Audio.gain gainNode].
Restituisce il valore di [page:Audio.playbackRate playbackRate].
Restituisce il volume corrente.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] è impostato a true, inizia la riproduzione.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] è impostato a true, mette in pausa la riproduzione.
Viene chiamato automaticamente quando la riproduzione termina.
Imposta la [page:Audio.source sorgente] su audioBuffer, e imposta il [page:Audio.sourceType sourceType] a 'buffer'.
Se la riproduzione è in [page:Audio.autoplay autoplay], avvia anche la riproduzione.
Definisce il detuning dell'oscillazione in centesimi.
Applica un singolo filtro all'audio.
value - array di filtri.
Applica un array di filtri all'audio.
Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] a `value` (se la riproduzione deve andare in loop).
Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] a `value`.
Imposta [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] a `value`.
Applica l'oggetto passato come parametro, di tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement],
come sorgente di questo audio.
Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false.
Applica l'oggetto passato come parametro, di tipo [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream],
come sorgente di questo audio.
Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false.
Imposta la [page:Audio.source sorgente] dell'audioBuffer, e imposta [page:Audio.sourceType sourceType] a 'audioNode'.
Inoltre imposta [page:Audio.hasPlaybackControl hasPlaybackControl] a false.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] è abilitato, imposta il [page:Audio.playbackRate playbackRate] a `value`.
Imposta il volume.
Se [page:Audio.hasPlaybackControl hasPlaybackControl] è abilitato, ferma la riproduzione.
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]