123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <meta charset="utf-8" />
- <base href="../../" />
- <script src="list.js"></script>
- <script src="page.js"></script>
- <link type="text/css" rel="stylesheet" href="page.css" />
- </head>
- <body>
- [page:Object3D] →
- <h1>[name]</h1>
- <p class="desc">
- The [name] represents a virtual [link:https://developer.mozilla.org/de/docs/Web/API/AudioListener listener] of the all positional and non-positional audio effects in the scene.</br>
- A three.js application usually creates a single instance of [name]. It is a mandatory construtor parameter for audios entities like [page:Audio Audio] and [page:PositionalAudio PositionalAudio].</br>
- In most cases, the listener object is a child of the camera. So the 3D transformation of the camera represents the 3D transformation of the listener.
- </p>
- <h2>Example</h2>
- <p>
- [example:webaudio_sandbox webaudio / sandbox ]</br>
- [example:webaudio_timing webaudio / timing ]</br>
- [example:webaudio_visualizer webaudio / visualizer ]
- </p>
- <code>
- // create an AudioListener and add it to the camera
- var listener = new THREE.AudioListener();
- camera.add( listener );
- // create a global audio source
- var sound = new THREE.Audio( listener );
- // load a sound and set it as the Audio object's buffer
- var audioLoader = new THREE.AudioLoader();
- audioLoader.load( 'sounds/ambient.ogg', function( buffer ) {
- sound.setBuffer( buffer );
- sound.setLoop(true);
- sound.setVolume(0.5);
- sound.play();
- });
- </code>
- <h2>Constructor</h2>
- <h3>[name]( )</h3>
- <p>
- Create a new AudioListener.
- </p>
- <h2>Properties</h2>
- <h3>[property:AudioContext context]</h3>
- <p>The [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext] of the [page:AudioListener listener] given in the constructor.</p>
- <h3>[property:GainNode gain]</h3>
- <p>A [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode] created
- using [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]().</p>
- <h3>[property:AudioNode filter]</h3>
- <p>Default is *null*.</p>
- <h2>Methods</h2>
- <h3>[method:GainNode getInput]()</h3>
- <p>
- Return the [page:AudioListener.gain gainNode].
- </p>
- <h3>[method:AudioListener removeFilter]()</h3>
- <p>
- Set the [page:AudioListener.filter filter] property to *null*.
- </p>
- <h3>[method:AudioNode getFilter]()</h3>
- <p>
- Returns the value of the [page:AudioListener.filter filter] property.
- </p>
- <h3>[method:AudioListener setFilter]( [param:AudioNode value] )</h3>
- <p>
- Set the [page:AudioListener.filter filter] property to *value*.
- </p>
- <h3>[method:Float getMasterVolume]()</h3>
- <p>
- Return the volume.
- </p>
- <h3>[method:AudioListener setMasterVolume]( [param:Number value] )</h3>
- <p>
- Set the volume.
- </p>
- <h2>Source</h2>
- [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
- </body>
- </html>
|