Sur cette page

QAudioListener Class

Définit la position et l'orientation de la personne qui écoute un champ sonore défini par QAudioEngine. En savoir plus...

En-tête : #include <QAudioListener>
CMake : find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)
qmake : QT += spatialaudio
Hérite de : QObject

Fonctions publiques

QAudioListener(QAudioEngine *engine)
virtual ~QAudioListener() override
QAudioEngine *engine() const
QVector3D position() const
QQuaternion rotation() const
void setPosition(QVector3D pos)
void setRotation(const QQuaternion &q)

Description détaillée

Un objet « QAudioEngine » peut avoir exactement un auditeur qui définit la position et l'orientation de la personne écoutant le champ sonore.

Documentation des fonctions membres

[explicit] QAudioListener::QAudioListener(QAudioEngine *engine)

Crée un écouteur pour le moteur audio spatial destiné à engine.

Remarque : doit être appelé avec un QAudioEngine

[override virtual noexcept] QAudioListener::~QAudioListener()

Supprime l'écouteur.

QAudioEngine *QAudioListener::engine() const

Renvoie le moteur associé à cet écouteur.

QVector3D QAudioListener::position() const

Renvoie la position actuelle de l'écouteur.

Voir aussi setPosition().

QQuaternion QAudioListener::rotation() const

Renvoie l'orientation de l'auditeur dans l'espace 3D.

Voir également setRotation().

void QAudioListener::setPosition(QVector3D pos)

Définit la position de l'observateur dans l'espace 3D à l'adresse pos. Les unités sont exprimées en centimètres par défaut.

Voir également position() et QAudioEngine::distanceScale.

void QAudioListener::setRotation(const QQuaternion &q)

Définit l'orientation de l'observateur dans l'espace 3D sur q.

Voir aussi rotation().

© 2026 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.