AudioListener

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

AudioListener インターフェイスは、この音場を聞いている固有の人物の位置と方向を表し、それが音声空間処理に使用されます。すべてのPannerNode は、BaseAudioContext.listener 属性に格納されているAudioListener からの相対で空間化されます。

注意点としては、聞き手は 1 つのコンテキストにつき 1 人しかおらず、AudioNode ではないことです。

AudioListener の位置、上方、前方ベクトルを、上方・前方ベクトルが互いに 90° になるように表示したものです。

インスタンスプロパティ

メモ:position、forward、up の値の設定と取得は異なる構文で行われます。取得は例えば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 です。