Classe per il caricamento di un [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioBuffer AudioBuffer]. Utilizza internamente il [page:FileLoader] per caricare i file.
// istanzia il listener
const audioListener = new THREE.AudioListener();
// aggiunge il listener alla telecamera
camera.add( audioListener );
// istanzia un oggetto audio
const oceanAmbientSound = new THREE.Audio( audioListener );
// aggiunge l'oggetto audio alla scena
scene.add( oceanAmbientSound );
// istanzia un loader
const loader = new THREE.AudioLoader();
// carica una risorsa
loader.load(
// URL della risorsa
'audio/ambient_ocean.ogg',
// onLoad callback
function ( audioBuffer ) {
// imposta il buffer dell'oggetto audio nell'oggetto caricato
oceanAmbientSound.setBuffer( audioBuffer );
// avvia l'audio
oceanAmbientSound.play();
},
// onProgress callback
function ( xhr ) {
console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
},
// onError callback
function ( err ) {
console.log( 'An error happened' );
}
);
[page:LoadingManager manager] — Il [page:LoadingManager loadingManager] del loader da utilizzare. Il valore predefinito è [page:LoadingManager THREE.DefaultLoadingManager].
Crea un nuovo [name].
Vedi la classe base [page:Loader] per le proprietà comuni.
Vedi la classe base [page:Loader] per i metodi comuni.
[page:String url] — Il path o URL del file. Questo può anche essere un
[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].
[page:Function onLoad] — Verrà chiamato quando il caricamento sarà completato. L'argomento sarà la risposta del testo caricato.
[page:Function onProgress] (opzionale) — Verrà chiamato durante il caricamento. L'argomento sarà l'istanza ProgressEvent, la quale contiene
.[page:Boolean lengthComputable], .[page:Integer total] e .[page:Integer loaded]. Se il server non imposta l'header Content-Length; .[page:Integer total] sarà 0.
[page:Function onError] (opzionale) — Verrà chiamato in caso di errori di caricamento.
Inizia il caricamento dall'url e passa l'[page:String AudioBuffer] caricato a onLoad.
[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]