--- title: PannerNode slug: Web/API/PannerNode translation_of: Web/API/PannerNode --- <p>{{ APIRef("Web Audio API") }}</p> <div> <div class="note_trans"> <div>Интерфейс <code>PannerNode</code> представляет положение источника звука и поведение его сигнала в пространстве. Это модуль {{domxref("AudioNode")}} для обработки звука, описывающий его положение (в правосторонней системе координат Декарта), его перемещение (с помощью вектора скорости распространения) и его направленности (при помощи конуса направления).</div> </div> </div> <div class="note_trans"> <div><code>PannerNode</code> всегда имеет только один вход и один выход: вход может быть <em>моно</em> или <em>стерео</em>, но выход всегда <em>стерео</em> (2 канала); нельзя получить эффекты панорамирования при отсутствии, как минимум двух аудиоканалов!</div> </div> <p><img alt="PannerNode задаёт положение в пространстве, скорость распространения и направленность данного сигнала." src="https://mdn.mozillademos.org/files/15375/PannerNode.png" style="height: 263px; margin-left: 20px; margin-right: 20px; width: 720px;"></p> <table class="properties"> <tbody> <tr> <th scope="row">Число входов</th> <td><code>1</code></td> </tr> <tr> <th scope="row">Число выходов</th> <td><code>1</code></td> </tr> <tr> <th scope="row">Режим подсчёта каналов</th> <td><code>"clamped-max"</code></td> </tr> <tr> <th scope="row">Количество каналов</th> <td><code>2</code></td> </tr> <tr> <th scope="row">Представление канала</th> <td><code>"speakers"</code></td> </tr> </tbody> </table> <h2 id="Конструктор">Конструктор</h2> <dl> <dt>{{domxref("PannerNode.PannerNode")}}</dt> <dd> <div class="note_trans"> <div> <dl> <dd>Создаёт новый экземпляр <code>PannerNode.</code></dd> </dl> </div> </div> </dd> </dl> <h2 id="Свойства">Свойства</h2> <div class="note_trans"> <div>Наследует свойства от своего родителя<em>, {{domxref("AudioNode")}}</em>. </div> </div> <div class="note"> <p>Значения направления и положения устанавливаются и получаются различными вариантами синтаксиса, поскольку они хранятся в виде значений {{domxref("AudioParam")}}. Получение значения осуществляется через обращение, например так,<code> PannerNode.positionX</code>. Установка того же свойства делается так,<code> PannerNode.positionX.value</code>. This is why these values are not marked read only, which is how they appear in the WebIDL.</p> </div> <dl> <dt>{{domxref("PannerNode.coneInnerAngle")}}</dt> <dd>Это значение типа <code> double</code>, представляющее угол конуса (в градусах), внутри которого не будет уменьшения громкости.</dd> <dt>{{domxref("PannerNode.coneOuterAngle")}}</dt> <dd>Это значение типа <code> double</code>, представляющее угол конуса (в градусах), вне которого громкость звука будет уменьшена на постоянное значение, определяемое атрибутом <code>coneOuterGain.</code></dd> <dt>{{domxref("PannerNode.coneOuterGain")}}</dt> <dd>Это значение типа <code>double</code>, представляющее величину снижения уровня громкости вне конуса, определённого атрибутом <code>coneOuterAngle</code>. Значение по умолчанию равно <code>0</code>, то есть, вне конуса звук не будет слышен.</dd> <dt>{{domxref("PannerNode.distanceModel")}}</dt> <dd>Перечислимое значение, определяющее, какой алгоритм будет использован для уменьшения громкости источника звука при удалении его от слушателя.</dd> <dt>{{domxref("PannerNode.maxDistance")}}</dt> <dd>Значение типа <code>double</code>, представляющее максимальное расстояние между источником звука и слушателем, после которого громкость звука далее не уменьшается.</dd> <dt>{{domxref("PannerNode.orientationX")}}</dt> <dd>Представляет горизонтальное положение вектора источника звука в правосторонней системе координат Декарта. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}} . Значение по умолчанию равно 1.</dd> <dt>{{domxref("PannerNode.orientationY")}}</dt> <dd>Представляет вертикальное положение вектора источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}}. Значение по умолчанию равно 0.</dd> <dt>{{domxref("PannerNode.orientationZ")}}</dt> <dd>Представляет продольную (вперёд - назад) позицию вектора распространения звука от источника в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}}. Значение по умолчанию равно 0.</dd> <dt>{{domxref("PannerNode.panningModel")}}</dt> <dd>Перечислимое значение, определяющее какой алгоритм пространственной обработки используется для размещения источника звука в трёхмерном пространстве.</dd> <dt>{{domxref("PannerNode.positionX")}}</dt> <dd>Представляет горизонтальное положение источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}}. Значение по умолчанию равно 0.</dd> <dt>{{domxref("PannerNode.positionY")}}</dt> <dd>Представляет вертикальное положение источника звука в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}}. Значение по умолчанию равно 0.</dd> <dt>{{domxref("PannerNode.positionZ")}}</dt> <dd>Представляет позицию источника звука вдоль оси Z (вперёд и назад) в правосторонней системе координат Декарта. Значение по умолчанию равно 0. В то время как данный {{domxref("AudioParam")}} непосредственно изменить нельзя, его значение может быть изменено через его свойство {{domxref("AudioParam.value", "value")}}. Значение по умолчанию равно 0.</dd> <dt>{{domxref("PannerNode.refDistance")}}</dt> <dd>Значение типа <code>double</code>, представляющее справочное (опорное) расстояние для уменьшения громкости при удалении источника звука от слушателя.</dd> <dt>{{domxref("PannerNode.rolloffFactor")}}</dt> <dd>Значение типа <code>double</code>, представляющее как быстро уменьшается громкость при удалении источника звука от слушателя. Данное значение используется во всех моделях изменения громкости от расстояния.</dd> </dl> <h2 id="Методы">Методы</h2> <div class="note_trans"> <div>Наследует методы от своего родителя<em>, {{domxref("AudioNode")}}</em>.</div> <div> </div> </div> <dl> <dt>{{domxref("PannerNode.setPosition()")}}</dt> <dd>Определяет положение источника звука относительно слушателя (представлен объектом {{domxref("AudioListener")}}, хранящимся в атрибуте {{domxref("AudioContext.listener")}} ).</dd> </dl> <dl> <dt>{{domxref("PannerNode.setOrientation()")}}</dt> <dd>Определяет направление воспроизведения источника звука.</dd> </dl> <dl> <dt>{{domxref("PannerNode.setVelocity()")}} {{obsolete_inline}}</dt> <dd>Это устаревший элемент API и его работа в дальнейшем не гарантируется.<br> Определяет вектор распространения звука от источника - как быстро он движется и в каком направлении. В предыдущей версии спецификации, {{domxref("PannerNode")}} имел скорость распространения, которую можно было выдать выше или ниже подключённого потока {{domxref("AudioBufferSourceNode")}}. Эта функция не была чётко оговорена и имела ряд проблем, поэтому была удалена из спецификации.</dd> </dl> <h2 id="Примеры">Примеры</h2> <p>{{page("/ru/docs/Web/API/AudioContext.createPanner","Example")}}</p> <h2 id="Specifications">Specifications</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Specification</th> <th scope="col">Status</th> <th scope="col">Comment</th> </tr> <tr> <td>{{SpecName('Web Audio API', '#the-pannernode-interface', 'PannerNode')}}</td> <td>{{Spec2('Web Audio API')}}</td> <td> </td> </tr> </tbody> </table> <h2 id="Browser_compatibility">Browser compatibility</h2> <p>{{Compat}}</p> <h2 id="Смотрите_также">Смотрите также</h2> <ul> <li><a href="/en-US/docs/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li> <li><a href="http://musiconnect.ru/publ/mixmaster/osnovy-panoramirovaniya-raspolozhenie-zvukov-v-virtualnom-prostranstve-ch-1/">Основы панорамирования. Расположение звуков в виртуальном пространстве.</a></li> </ul>