AudioListener

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

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 です。

インスタンスメソッド

AudioListener.setOrientation() 非推奨;

聞き手の向きを設定します。

AudioListener.setPosition() 非推奨;

聞き手の位置を設定します。

メモ: これらのメソッドは非推奨ですが、現在、 Firefox で方向と位置を設定するための唯一の方法となっています。

非推奨の機能

setOrientation() および setPosition() メソッドは、それらのプロパティ値を同等に設定することで置き換えられました。 例えば、 setPosition(x, y, z) は、それぞれ positionX.value, positionY.value および positionZ.value を設定することによって実現できます。

サンプルコードは BaseAudioContext.createPanner() を参照してください。

仕様書

Specification
Web Audio API
# AudioListener

ブラウザーの互換性

BCD tables only load in the browser

関連情報