PositionalAudio - Руководство по Вердж3Д - Софт Эйт Софт
Description: Узнайте как использовать PositionalAudio в интерактивных 3Д-веб-приложениях сделанных на Вердж3Д

Object3D → Audio →

# PositionalAudio

Создаёт позиционный аудиообъект.

Использует Web Audio API.

## Пример

`// создаём AudioListener и добавляем его к камере const listener = new v3d.AudioListener(); camera.add(listener); // создаём объект PositionalAudio (добавляем к listener) const sound = new v3d.PositionalAudio(listener); // загружаем звук и добавляем как буфер для PositionalAudio const audioLoader = new v3d.AudioLoader(); audioLoader.load('mysong.mp3', function(buffer) { sound.setBuffer(buffer); sound.setRefDistance(20); sound.play(); }); // создаём объект-источник const sphere = new v3d.SphereGeometry(20, 32, 16); const material = new v3d.MeshStandardMaterial({ color: 0xff2200 }); const mesh = new v3d.Mesh(sphere, material); app.scene.add(mesh); // добавляем звук к источнику mesh.add(sound);`

## Конструктор

### PositionalAudio(listener : AudioListener)

listener — (необходимый) экземпляр AudioListener.

## Свойства

Наследуемые свойства смотрите в классе Audio.

### # .panner : PannerNode

Нода PositionalAudio PannerNode.

## Методы

Наследуемые методы смотрите в классе Audio.

### # .getOutput() → PannerNode

Возвращает panner.

### # .getRefDistance() → Float

Возвращает значение параметра panner.refDistance.

### # .setRefDistance(value : Float) → this

Устанавливает значение параметра panner.refDistance.

### # .getRolloffFactor() → Float

Возвращает значение параметра panner.rolloffFactor.

### # .setRolloffFactor(value : Float) → this

Устанавливает значение параметра panner.rolloffFactor.

### # .getDistanceModel() → String

Возвращает значение параметра panner.distanceModel.

### # .setDistanceModel(value : String) → this

Устанавливает значение параметра panner.distanceModel.

### # .getMaxDistance() → Float

Возвращает значение параметра panner.maxDistance.

### # .setMaxDistance(value : Float) → this

Устанавливает значение параметра panner.maxDistance.

### # .setDirectionalCone(coneInnerAngle : Float, coneOuterAngle : Float, coneOuterGain : Float) → this

Этот метод можно использовать для преобразования всенаправленного звука в направленный.

## Пазлы

«Вердж3Д» поддерживает пазл positional speaker, упрощающий работу с позиционными источниками аудио.

## Исходный файл

О том как получить исходный код этого модуля читайте тут.