# Class pyglet.media.Listener

The listener properties for positional audio.

You can obtain the singleton instance of this class as pyglet.media.listener.

## Properties

float | volume The master volume for sound playback.
3-tuple of float | position The position of the listener in 3D space.
3-tuple of float | forward_orientation A vector giving the direction the listener is facing.
3-tuple of float | up_orientation A vector giving the "up" orientation of the listener.

## Property Details

### volume

The master volume for sound playback.

All sound volumes are multiplied by this master volume before being played. A value of 0 will silence playback (but still consume resources). The nominal volume is 1.0.

Type:
  float

### position

The position of the listener in 3D space.

The position is given as a tuple of floats (x, y, z). The unit defaults to meters, but can be modified with the listener properties.

Type:
  3-tuple of float

### forward_orientation

A vector giving the direction the listener is facing.

The orientation is given as a tuple of floats (x, y, z), and has no unit. The forward orientation should be orthogonal to the up orientation.

Type:
  3-tuple of float

### up_orientation

A vector giving the "up" orientation of the listener.

The orientation is given as a tuple of floats (x, y, z), and has no unit. The up orientation should be orthogonal to the forward orientation.

Type:
  3-tuple of float