Back to Qt.io
Contact Us Blog Download Qt

AudioListener QML Type

Control global listener parameters. More...

Import Statement: import QtAudioEngine 1.15
Since: Qt 5.0
Inherits:

Item

Properties

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.


© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.