Crée un objet audio non-positionnel ( global ).
La [link:https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API Web Audio API] est utilisée.
// 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 — (requis) instance d'[page:AudioListener AudioListener].
Démarrage automatique de la lecture. La valeur par défaut est `false`.
L'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] du [page:AudioListener listener] passé au constructeur.
Modifie le ton, mesuré en centaines. +/- 100 est un demi-ton. +/- 1200 est un octave. La valeur par défaut est `0`.
Représente un tableau d'[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioNode AudioNodes]. Peut être utilisé pour appliquer une variété de filtres d'ordres inférieurs pour créer des effets sonores complexes. Dans la plupart des cas, le tableau contient des instances de [link:https://developer.mozilla.org/en-US/docs/Web/API/BiquadFilterNode BiquadFilterNodes]. Les filtres sont appliqués via [page:Audio.setFilter] ou [page:Audio.setFilters].
Un [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] créé en utilisant [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().
Définit si la lecture peut-être contrôlée en utilisant les méthodes [page:Audio.play play](), [page:Audio.pause pause]() etc. La valeur par défaut est `true`.
Indique si l'audio est en cours de lecture.
Une reference à l'objet listener de cet audio.
Vitesse de lecture. La valeur par défaut est `1`.
Un décalage temporel après lequel la lecture doit commencer. Équivalent au paramètre `offset` de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). La valeur par défaut est `0`.
Écrase la durée de l'audio. Équivalent au paramètre `duration` de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/start AudioBufferSourceNode.start](). La valeur par défaut est `undefined` afin de jour le buffer entier.
Un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode AudioBufferSourceNode] créé en utilisant [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createBufferSource AudioContext.createBufferSource]().
Type de source audio. La valeur par défaut est 'empty'.
String indiquant le type, contenant 'Audio'.
Connecte à la [page:Audio.source] audio. Ceci est utilisé en interne à l'initialisation et lors de l'ajout/retrait de filtres.
Déconnecte de la [page:Audio.source]. Ceci est utilisé en interne lors de l'ajout/retrait de filtres.
Renvoie le detuning de l'oscillation en centaines.
Renvoie le premier élément du tableau [page:Audio.filters filters].
Renvoie le tableau [page:Audio.filters filters].
Renvoie la valeur de [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] (Indique si la lecture doit boucler).
Renvoie le [page:Audio.gain gainNode].
Renvoie la valeur de [page:Audio.playbackRate playbackRate].
Renvoie le volume actuel.
Si [page:Audio.hasPlaybackControl hasPlaybackControl] est à true, la lecture se lance.
Si [page:Audio.hasPlaybackControl hasPlaybackControl] est à true, la lecture se met en pause.
Appelée automatiquement quand la lecture est terminée.
Met la [page:Audio.source source] à audioBuffer, et met le [page:Audio.sourceType sourceType] à 'buffer'.
Si [page:Audio.autoplay autoplay] est activé, la méthode démarrera également la lecture.
Définit le detuning de l'oscillation en centaines.
Applique un noeud à filtre unique à l'audio.
value - tableau de filtres.
Applique un tableau de noeuds de filtres à l'audio.
Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loop source.loop] à `value` (Indique si la lecture doit boucler).
Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopStart source.loopStart] à `value`.
Met [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBufferSourceNode/loopEnd source.loopEnd] à `value`.
Définit le type d'objet passé en paramètre [link:https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement HTMLMediaElement] comme source de l'audio.
Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
Définit le type d'objet passé en paramètre [link:https://developer.mozilla.org/en-US/docs/Web/API/MediaStream MediaStream] comme source de l'audio.
Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
Met la [page:Audio.source source] à audioBuffer, et met le [page:Audio.sourceType sourceType] à 'audioNode'.
Met également [page:Audio.hasPlaybackControl hasPlaybackControl] à false.
Si [page:Audio.hasPlaybackControl hasPlaybackControl] est activé, mets le [page:Audio.playbackRate playbackRate] à `value`.
Modifie le volume.
Si [page:Audio.hasPlaybackControl hasPlaybackControl] est activé, la lecture est stoppée.
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]