Spec-Zone.ru › Web APIs

PannerNode

Базовая реализация Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Интерфейс PannerNode определяет аудиообъект обработки, представляющий расположение, направление и поведение сигнала аудиоисточника в симулированном физическом пространстве. Этот AudioNode использует правую декартову систему координат для описания положения источника как вектора и его ориентации как 3D-направляющего конуса.

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

The PannerNode defines a spatial position and direction for a given signal.

EventTarget AudioNode PannerNode
Количество входов 1
Количество выходов 1
Режим количества каналов "clamped-max"
Количество каналов 2
Интерпретация каналов "speakers"

Конструктор

PannerNode()

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

Свойства экземпляра

Наследует свойства от своего родителя, AudioNode.

Примечание: Значения ориентации и положения устанавливаются и извлекаются с помощью различных синтаксисов, так как они хранятся как значения AudioParam. Извлечение выполняется, например, через PannerNode.positionX. Установка тех же свойств выполняется с помощью PannerNode.positionX.value. Вот почему эти значения не помечены как только для чтения, так как они отображаются в WebIDL.

PannerNode.coneInnerAngle

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

PannerNode.coneOuterAngle

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

PannerNode.coneOuterGain

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

PannerNode.distanceModel

Перечислимое значение, определяющее алгоритм для снижения громкости источника звука по мере удаления его от слушателя. Возможные значения - "linear", "inverse" и "exponential". Значение по умолчанию - "inverse".

PannerNode.maxDistance

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

PannerNode.orientationX

Представляет горизонтальное положение вектора источника звука в правой декартовой системе координат. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 1.

PannerNode.orientationY

Представляет вертикальное положение вектора источника звука в правой декартовой системе координат. Значение по умолчанию равно 0. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 0.

PannerNode.orientationZ

Представляет продольное (вперёд-назад) положение вектора источника звука в правой декартовой системе координат. Значение по умолчанию равно 0. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 0.

PannerNode.panningModel

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

PannerNode.positionX

Представляет горизонтальное положение звука в правой декартовой системе координат. Значение по умолчанию равно 0. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 0.

PannerNode.positionY

Представляет вертикальное положение звука в правой декартовой системе координат. Значение по умолчанию равно 0. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 0.

PannerNode.positionZ

Представляет продольное (вперёд-назад) положение звука в правой декартовой системе координат. Значение по умолчанию равно 0. Хотя этот AudioParam не может быть изменён напрямую, его значение может быть изменено с помощью свойства value. Значение по умолчанию равно 0.

PannerNode.refDistance

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

PannerNode.rolloffFactor

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

Методы экземпляра

Наследует методы от своего родителя, AudioNode.

PannerNode.setPosition() Устаревшее

Определяет положение источника звука относительно слушателя (представленного объектом AudioListener, хранящимся в атрибуте BaseAudioContext.listener).

PannerNode.setOrientation() Устаревшее

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

Примеры

См. BaseAudioContext.createPanner() для примеров кода.

Спецификации

Спецификация
Web Audio API
# PannerNode

Совместимость браузеров

Настольные Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
PannerNode 55 79 53 42 14.1 55 53 42 14.5 6.0 55
PannerNode 14 12 25 15 6 18 25 14 6 1.0 4.4.3
coneInnerAngle 14 12 25 15 6 18 25 14 6 1.0 4.4.3
coneOuterAngle 14 12 25 15 6 18 25 14 6 1.0 4.4.3
coneOuterGain 14 12 25 15 6 18 25 14 6 1.0 4.4.3
distanceModel 14 12 25 15 6 18 25 14 6 1.0 4.4.3
maxDistance 14 12 25 15 6 18 25 14 6 1.0 4.4.3
orientationX 52 79 50 39 14.1 52 50 41 14.5 6.0 52
orientationY 52 79 50 39 14.1 52 50 41 14.5 6.0 52
orientationZ 52 79 50 39 14.1 52 50 41 14.5 6.0 52
panningModel 14 12 25 15 6 18 25 14 6 1.0 4.4.3
positionX 52 79 50 39 14.1 52 50 41 14.5 6.0 52
positionY 52 79 50 39 14.1 52 50 41 14.5 6.0 52
positionZ 52 79 50 39 14.1 52 50 41 14.5 6.0 52
refDistance 14 12 25 15 6 18 25 14 6 1.0 4.4.3
rolloffFactor 14 12 25 15 6 18 25 14 6 1.0 4.4.3
setOrientation 14 12 25 15 6 18 25 14 6 1.0 4.4.3
setPosition 14 12 25 15 6 18 25 14 6 1.0 4.4.3

См. также

  • Использование Web Audio API

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PannerNode

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API