AudioListener: setPosition() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die setPosition()-Methode der AudioListener-Schnittstelle definiert die Position des Hörers.

Die drei Parameter x, y und z sind einheitenlos und beschreiben die Position des Hörers im 3D-Raum gemäß dem kartesischen Rechtshändersystem. PannerNode-Objekte verwenden diese Position relativ zu den einzelnen Audioquellen zur räumlichen Klangdarstellung.

Der Standardwert des Positionsvektors ist (0, 0, 0).

Hinweis: Da diese Methode veraltet ist, verwenden Sie stattdessen die drei Eigenschaften positionX, positionY und positionZ.

Syntax

js
setPosition(x, y, z)

Parameter

x

Die x-Position des Hörers im 3D-Raum.

y

Die y-Position des Hörers im 3D-Raum.

z

Die z-Position des Hörers im 3D-Raum.

Rückgabewert

Keiner (undefined).

Beispiele

Siehe BaseAudioContext.createPanner() für Beispielcode.

Spezifikationen

Specification
Web Audio API
# dom-audiolistener-setposition

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch