AudioListener
Базовая поддержка Широко доступна *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с апреля 2021 года.
* Некоторые части этой функции могут иметь различный уровень поддержки.
Интерфейс AudioListener представляет положение и ориентацию единственного человека, слушающего звуковую сцену, и используется в пространственной обработке звука. Все PannerNode пространственно обрабатываются относительно AudioListener, хранящегося в атрибуте BaseAudioContext.listener.
Важно отметить, что на один контекст приходится только один слушатель, и он не является AudioNode.
Свойства экземпляра
Примечание: Значения положения, направления вперед и вверх устанавливаются и извлекаются с помощью различных синтаксисов. Извлечение выполняется, например, с помощью AudioListener.positionX, а установка того же свойства выполняется с помощью AudioListener.positionX.value. Вот почему эти значения не помечены как только для чтения, так как это отображается в IDL спецификации.
AudioListener.positionX-
Представляет горизонтальное положение слушателя в декартовой системе координат с правой ориентацией. Значение по умолчанию 0.
AudioListener.positionY-
Представляет вертикальное положение слушателя в декартовой системе координат с правой ориентацией. Значение по умолчанию 0.
AudioListener.positionZ-
Представляет продольное (вперед-назад) положение слушателя в декартовой системе координат с правой ориентацией. Значение по умолчанию 0.
AudioListener.forwardX-
Представляет горизонтальное положение направления вперед слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию 0. AudioListener.forwardY-
Представляет вертикальное положение направления вперед слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию 0. AudioListener.forwardZ-
Представляет продольное (вперед-назад) положение направления вперед слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию -1. AudioListener.upX-
Представляет горизонтальное положение верхней точки головы слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию 0. AudioListener.upY-
Представляет вертикальное положение верхней точки головы слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию 1. AudioListener.upZ-
Представляет продольное (вперед-назад) положение верхней точки головы слушателя в той же декартовой системе координат, что и значения положения (
positionX,positionY, иpositionZ) . Значения вперед и вверх линейно независимы друг от друга. Значение по умолчанию 0.
Методы экземпляра
-
AudioListener.setOrientation()Устаревший -
Устанавливает ориентацию слушателя.
-
AudioListener.setPosition()Устаревший -
Устанавливает положение слушателя.
Примечание: Хотя эти методы устарели, в настоящее время они являются единственным способом установить ориентацию и положение в Firefox (см. ошибку Firefox 1283029).
Устаревшие функции
Методы setOrientation() и setPosition() были заменены на установку эквивалентных значений свойств. Например, setPosition(x, y, z) можно достичь, установив соответственно positionX.value, positionY.value, и positionZ.value.
Пример
См. BaseAudioContext.createPanner() для примера кода.
Спецификации
| Спецификация |
|---|
| Web Audio API # AudioListener |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
AudioListener |
14 | 12 | 25 | 15 | 6 | 18 | 25 | 14 | 6 | 1.0 | 4.4.3 |
forwardX |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
forwardY |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
forwardZ |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
positionX |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
positionY |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
positionZ |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
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 |
upX |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
upY |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
upZ |
52 | 79 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
39 | 14.1 | 52 | НетПоддерживает устаревший способ установки ориентации — методsetOrientation(). |
41 | 14.5 | 6.0 | 52 |
См. также
© 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/AudioListener
