---
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>