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.

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

インスタンスメソッド

AudioListener.setOrientation() 非推奨;

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

AudioListener.setPosition() 非推奨;

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

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

非推奨の機能

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

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

仕様書

Specification
Web Audio API
# AudioListener

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
AudioListener
forwardX
forwardY
forwardZ
positionX
positionY
positionZ
setOrientation
Deprecated
setPosition
Deprecated
upX
upY
upZ

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.

関連情報