- Qt 5.15
- Qt Multimedia
- QML Types
- AudioListener QML Type
- Qt 5.15.17 Reference Documentation

# AudioListener QML Type

Control global listener parameters. More...

Import Statement: | import QtAudioEngine 1.15
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.