[page:Object3D] →

# [name]

[name]는 장면 안의 모든 지정 및 비지정 오디오 효과의 가상 [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioListener listener]입니다.
three.js 앱은 일반적으로 단일 [name] 인스턴스를 생성합니다. 이는 [page:Audio Audio]와 [page:PositionalAudio PositionalAudio] 같은 오디오 개체의 필수 생성자 파라미터입니다.
대부분의 경우, 리스너 오브젝트는 카메라의 자식입니다. 그래서 카메라의 3D 변환은 곧 리스너의 3D 변환이 됩니다.

## 코드 예제

`// 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_timing webaudio / timing ]
[example:webaudio_visualizer webaudio / visualizer ]

## 생성자

### [name]( )

새 AudioListener를 만듭니다.

## 프로퍼티

### [property:AudioContext context]

생성자로 만들어진 [page:AudioListener listener]의 [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext AudioContext]입니다.

### [property:GainNode gain]

[link:https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain AudioContext.createGain]()을 사용해 만들어진 [link:https://developer.mozilla.org/en-US/docs/Web/API/GainNode GainNode]입니다.

### [property:AudioNode filter]

기본값은 *null*입니다.

### [property:Number timeDelta]

오디오 개체에 대한 시간 델타값입니다. [link:https://developer.mozilla.org/en-US/docs/Web/API/AudioParam/linearRampToValueAtTime AudioParam.linearRampToValueAtTimeDefault]()에서 사용됩니다. 기본값은 *0*입니다.

## 메서드

### [method:GainNode getInput]()

[page:AudioListener.gain gainNode]를 리턴합니다.

### [method:this removeFilter]()

[page:AudioListener.filter filter] 프로퍼티를 *null*로 설정합니다.

### [method:AudioNode getFilter]()

[page:AudioListener.filter filter] 프로퍼티의 값을 리턴합니다.

### [method:this setFilter]( [param:AudioNode value] )

[page:AudioListener.filter filter] 프로퍼티를 *value*로 설정합니다.

### [method:Float getMasterVolume]()

볼륨을 리턴합니다.

### [method:this setMasterVolume]( [param:Number value] )

볼륨을 설정합니다.

## 소스 코드

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]