QtAudioEngine.AudioListener

Control global listener parameters. More...

Import Statement: import QtAudioEngine 1.0
Since: Qt 5.0

Properties

Detailed Description

This type is part of the QtAudioEngine 1.0 module.

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

import QtQuick 2.0
import QtAudioEngine 1.0
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:

import QtQuick 2.0
import QtAudioEngine 1.0
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.