PannerNode: orientationY property

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.

The orientationY property of the PannerNode interface indicates the Y (vertical) component of the direction the audio source is facing, in 3D Cartesian coordinate space.

The complete vector is defined by the position of the audio source, given as (positionX, positionY, positionZ), and the orientation of the audio source (that is, the direction in which it's facing), given as (orientationX, orientationY, orientationZ).

Depending on the directionality of the sound (as specified using the attributes coneInnerAngle, coneOuterAngle, and coneOuterGain), the orientation of the sound may alter the perceived volume of the sound as it's being played. If the sound is pointing toward the listener, it will be louder than if the sound is pointed away from the listener.

The AudioParam contained by this property is read only; however, you can still change the value of the parameter by assigning a new value to its AudioParam.value property.

Value

An AudioParam whose value is the Y component of the direction the audio source is facing, in 3D Cartesian coordinate space.

Examples

See PannerNode.orientationX for example code that demonstrates the effect on volume of changing the PannerNode orientation parameters in combination with coneInnerAngle and coneOuterAngle.

Specifications

Specification
Web Audio API
# dom-pannernode-orientationy

Browser compatibility

BCD tables only load in the browser

See also