PannerNode
Базовая реализация Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.
Интерфейс PannerNode определяет аудиообъект обработки, представляющий расположение, направление и поведение сигнала аудиоисточника в симулированном физическом пространстве. Этот AudioNode использует правую декартову систему координат для описания положения источника как вектора и его ориентации как 3D-направляющего конуса.
У PannerNode всегда ровно один вход и один выход: вход может быть моно или стерео, но выход всегда стерео (2 канала); эффекты панорамирования невозможны без как минимум двух аудиоканалов!
| Количество входов | 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 |
См. также
© 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