AudioListener: setPosition() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

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