Qt 5.9 | Qt Multimedia | QML Types | AudioListener QML Type

Qt 5.9.4 Reference Documentation

# AudioListener QML Type

Control global listener parameters. More...

Import Statement: | import QtAudioEngine 1.1
Since: | Qt 5.0

- List of all members, including inherited members

## Properties

- direction : vector3d
- engine : QtAudioEngine::AudioEngine
- gain : real
- position : vector3d
- up : vector3d
- velocity : vector3d

## Detailed Description

AudioListener will have only one global instance and you can either access it through the listener property of AudioEngine:

      Rectangle {
          color:"white"
          width: 300
          height: 500

          AudioEngine {
              id:audioengine
              listener.up:"0,0,1"
              listener.velocity:"0,0,0"
              listener.direction:"0,1,0"
              listener.position:Qt.vector3d(observer.x, observer.y, 0);
          }

          Item {
              id: observer
              x: 10 + observer.percent * 100
              y: 20 + observer.percent * 80
              property real percent: 0
              SequentialAnimation on percent {
                  loops: Animation.Infinite
                  running: true
                  NumberAnimation {
                      duration: 8000
                      from: 0
                      to: 1
                  }
              }
          }
      }

or alternatively, by defining an AudioListener outside AudioEngine:

      Rectangle {
          color:"white"
          width: 300
          height: 500

          AudioEngine {
              id:audioengine
              listener.up:"0,0,1"
              listener.velocity:"0,0,0"
              listener.direction:"0,1,0"
          }

          AudioListener {
              engine:audioengine
              position: Qt.vector3d(observer.x, observer.y, 0);
          }

          Item {
              id: observer
              x: 10 + observer.percent * 100
              y: 20 + observer.percent * 80
              property real percent: 0
              SequentialAnimation on percent {
                  loops: Animation.Infinite
                  running: true
                  NumberAnimation {
                      duration: 8000
                      from: 0
                      to: 1
                  }
              }
          }
      }

This separate AudioListener definition is allowed to make QML bindings easier in some cases.

## Property Documentation

direction : vector3d

This property holds the normalized 3D direction vector of the listener.

engine : QtAudioEngine::AudioEngine

This property holds the reference to AudioEngine, and must only be set once.

gain : real

This property will modulate all audio output from audio engine instances.

position : vector3d

This property holds the 3D position of the listener.

up : vector3d

This property holds the normalized 3D up vector of the listener.

velocity : vector3d

This property holds the 3D velocity vector of the listener.