Three.js

Интерфейс PannerNode представляет положение источника звука и поведение его сигнала в пространстве. Это модуль AudioNode для обработки звука, описывающий его положение (в правосторонней системе координат Декарта), его перемещение (с помощью вектора скорости распространения) и его направленности (при помощи конуса направления).

PannerNode всегда имеет только один вход и один выход: вход может быть моно или стерео, но выход всегда стерео (2 канала); нельзя получить эффекты панорамирования при отсутствии, как минимум двух аудиоканалов!

Конструктор

PannerNode.PannerNode

Создает новый экземпляр PannerNode.

Свойства

Наследует свойства от своего родителя,
для представления модуля обработки звука типа
источника звука (например, элементов HTML
‹audio› или ‹video›, OscillatorNode,
и т.п.), приемника звука, модуля промежуточной
обработки (например, фильтр вроде
BiquadFilterNode или ConvolverNode), или
управления громкостью (как GainNode).');" onmouseout="hide()" target="_blank">AudioNode.

PannerNode.coneInnerAngle

Это значение типа double, представляющее угол конуса (в градусах), внутри которого не будет уменьшения громкости.

PannerNode.coneOuterAngle

Это значение типа double, представляющее угол конуса (в градусах), вне которого громкость звука будет уменьшена на постоянное значение, определяемое атрибутом coneOuterGain.

PannerNode.coneOuterGain

Это значение типа double, представляющее величину снижения уровня громкости вне конуса, определенного атрибутом coneOuterAngle. Значение по умолчанию равно 0, то есть, вне конуса звук не будет слышен.

уровня громкости) от расстояния');" onmouseout="hide()">PannerNode.distanceModel

Перечислимое значение, определяющее, какой алгоритм будет использован для уменьшения громкости источника звука при удалении его от слушателя.

PannerNode.maxDistance

Значение типа double, представляющее максимальное расстояние между источником звука и слушателем, после которого громкость звука далее не уменьшается.

по оси X (по горизонтали)');" onmouseout="hide()">PannerNode.orientationX

Представляет горизонтальное положение вектора источника звука в правосторонней системе координат Декарта. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value. Значение по умолчанию равно 1.

по оси Y (по вертикали)');" onmouseout="hide()">PannerNode.orientationY

Представляет вертикальное положение вектора источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value. Значение по умолчанию равно 0.

по оси Z (вперед - назад)');" onmouseout="hide()">PannerNode.orientationZ

Представляет продольную (вперед - назад) позицию вектора распространения звука от источника в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value. Значение по умолчанию равно 0.

PannerNode.panningModel

Перечислимое значение, определяющее какой алгоритм пространственной обработки используется для размещения источника звука в трехмерном пространстве.

положения источника звука, в трехмерной системе
координат Декарта.');" onmouseout="hide()">PannerNode.positionX

Представляет горизонтальное положение источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value. Значение по умолчанию равно 0.

положения источника звука, в трехмерной системе
координат Декарта.');" onmouseout="hide()">PannerNode.positionY

Представляет вертикальное положение источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value. Значение по умолчанию равно 0.

положения источника звука, в трехмерной системе
координат Декарта.');" onmouseout="hide()">PannerNode.positionZ

Представляет позицию источника звука вдоль оси Z (вперед и назад) в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный
AudioParam: a-rate и k-rate.');" onmouseout="hide()">AudioParam непосредственно изменить нельзя, его значение может быть изменено через его свойство
происходят в то время как имеется запланированная
автоматизация событий — то есть, события запланированные
при помощи методов AudioParam - игнорируются, без
каких-либо исключений.');" onmouseout="hide()">value.

справочное (опорное) расстояние');" onmouseout="hide()">PannerNode.refDistance

Значение типа double, представляющее справочное (опорное) расстояние для уменьшения громкости при удалении источника звука от слушателя.

PannerNode.rolloffFactor

Значение типа double, представляющее как быстро уменьшается громкость при удалении источника звука от слушателя. Данное значение используется во всех моделях изменения громкости от расстояния.

Методы

Наследует методы от своего родителя,
для представления модуля обработки звука типа
источника звука (например, элементов HTML
‹audio› или ‹video›, OscillatorNode,
и т.п.), приемника звука, модуля промежуточной
обработки (например, фильтр вроде
BiquadFilterNode или ConvolverNode), или
управления громкостью (как GainNode).');" onmouseout="hide()" target="_blank">AudioNode.

PannerNode.setPosition()

Определяет положение источника звука относительно слушателя (представлен объектом
только один listener (слушатель) и это
не AudioNode.');" onmouseout="hide()">AudioListener, хранящимся в атрибуте AudioContext.listener.)

PannerNode.setOrientation()

Определяет направление воспроизведения источника звука.

PannerNode.setVelocity()

Это устаревший элемент API и его работа в дальнейшем не гарантируется.
Определяет вектор распространения звука от источника - как быстро он движется и в каком направлении. В предыдущей версии спецификации, PannerNode имел скорость распространения, которую можно было выдать выше или ниже
состоящий из аудиоданных в оперативной памяти, хранящихся в AudioBuffer.
Это AudioNode, который действует как источник звука.');" onmouseout="hide()">AudioBufferSourceNodes connected downstream. Эта функция не была четко оговорена и имела ряд проблем, поэтому была удалена из спецификации.

Пример

Ниже можно увидеть пример использования
только один listener (слушатель) и это
не AudioNode.');" onmouseout="hide()">AudioListener, PannerNode и метода createPanner() для управления пространством объемного звука. Обычно определяется положение в трехмерном пространстве, изначально занимаемое слушателем (listener) и источником звука (panner), а затем, при использовании приложения, обновляется позиция одного из них или обоих. Например, вы можете перемещать персонажа внутри игрового мира, и желательно чтобы передача звука изменялась реалистично, по мере приближения или отдаления персонажа относительно источника звука, вроде стереопроигрывателя. В этом примере можно видеть, что все это управляется функциями moveRight(), moveLeft(), и т.п., которые устанавливают новые значения для положения паннера через функцию PositionPanner().

Чтобы увидеть полную реализацию ознакомьтесь с нашим примером panner-node (просмотрите весь список примеров) — эта демонстрация перенесет вас в 2.5D "Room of metal" (2,5-мерную "металлическую комнату"), где можно проиграть трек на бумбоксе и затем походить вокруг него и посмотреть как изменяется звук!

Note how we have used some feature detection to either give the browser the newer property values (like
is an AudioParam representing the x value of the direction vector
defining the forward direction the listener is pointing in.');" onmouseout="hide()">AudioListener.forwardX) for setting position, etc. if it supports those, or older methods (like AudioListener.setOrientation()) if it still supports those but not the new properties.

// set up listener and panner position information
// установка сведений о слушателе и положении panner'а
var WIDTH = window.innerWidth;
var HEIGHT = window.innerHeight;

var xPos = Math.floor(WIDTH/2);
var yPos = Math.floor(HEIGHT/2);
var zPos = 295;

// define other variables (определяем другие переменные)

var AudioContext = window.AudioContext || window.webkitAudioContext;
var audioCtx = new AudioContext();

var panner = audioCtx.createPanner();
panner.panningModel = 'HRTF';
panner.distanceModel = 'inverse';
panner.refDistance = 1;
panner.maxDistance = 10000;
panner.rolloffFactor = 1;
panner.coneInnerAngle = 360;
panner.coneOuterAngle = 0;
panner.coneOuterGain = 0;

if(panner.orientationX) {
  panner.orientationX.value = 1;
  panner.orientationY.value = 0;
  panner.orientationZ.value = 0;
} else {
  panner.setOrientation(1,0,0);
}

var listener = audioCtx.listener;

if(listener.forwardX) {
  listener.forwardX.value = 0;
  listener.forwardY.value = 0;
  listener.forwardZ.value = -1;
  listener.upX.value = 0;
  listener.upY.value = 1;
  listener.upZ.value = 0;
} else {
  listener.setOrientation(0,0,-1,0,1,0);
}

var source;

var play = document.querySelector('.play');
var stop = document.querySelector('.stop');

var boomBox = document.querySelector('.boom-box');
var listenerData = document.querySelector('.listener-data');
var pannerData = document.querySelector('.panner-data');

leftBound = (-xPos) + 50;
rightBound = xPos - 50;

xIterator = WIDTH/150;

// listener will always be in the same place for this demo
// в этом демо listener всегда находится на одном месте

if(listener.positionX) {
  listener.positionX.value = xPos;
  listener.positionY.value = yPos;
  listener.positionZ.value = 300;
} else {
  listener.setPosition(xPos,yPos,300);
}

listenerData.innerHTML = 'Listener data: X ' + xPos + ' Y ' + yPos + ' Z ' + 300;

// panner will move as the boombox graphic moves around on the screen
// panner will move as the boombox graphic moves around on the screen
function positionPanner() {
  if(panner.positionX) {
    panner.positionX.value = xPos;
    panner.positionY.value = yPos;
    panner.positionZ.value = zPos;
  } else {
    panner.setPosition(xPos,yPos,zPos);
  }
  pannerData.innerHTML = 'Panner data: X ' + xPos + ' Y ' + yPos + ' Z ' + zPos;
}

Дополнительно о панорамировании звука можно почитать на сайте musiconnect.ru.