AudioEngine QML Type

AudioEngine verwaltet Klangobjekte innerhalb einer 3D-Szene. Mehr...

Import Statement: import QtQuick3D.SpatialAudio

Eigenschaften

Detaillierte Beschreibung

AudioEngine verwaltet Klangobjekte in einer 3D-Szene. Sie können der Szene SpatialSound Objekte hinzufügen, um Klänge zu definieren, die an einem bestimmten Ort im 3D-Raum stattfinden. AmbientSound ermöglicht es Ihnen, ein Stereo-Overlay hinzuzufügen (z. B. Voice Over oder eine Tonspur).

Mit AudioListener können Sie die Position der Person, die das Schallfeld hört, relativ zu den Schallquellen festlegen. Die Schallquellen sind weniger hörbar, wenn der Zuhörer weiter von der Quelle entfernt ist. Sie werden auch den entsprechenden Lautsprechern zugeordnet, abhängig von der Richtung zwischen Hörer und Quelle. In vielen Fällen kann das Objekt AudioListener einfach als Unterobjekt des Objekts QtQuick3D.camera instanziiert werden.

Erstellen Sie AudioRoom Objekte, um den Klang (Reflexionen und Nachhall) eines Raumes mit bestimmten Abmessungen und verschiedenen Wandtypen zu simulieren.

AudioEngine bietet einen Modus, in dem Qt die Auswirkungen des Ohrs mit Hilfe von kopfbezogenen Impulsreaktionsfunktionen simuliert (siehe auch https://en.wikipedia.org/wiki/Sound_localization), um den Klang im 3D-Raum zu lokalisieren, wenn Kopfhörer verwendet werden, und einen räumlichen Audioeffekt über Kopfhörer zu erzeugen.

Wie der Rest von Qt Quick 3D verwendet auch die Audio-Engine ein Koordinatensystem, das standardmäßig in Zentimetern angegeben ist. Die Achsen sind so definiert, dass positive x-Punkte nach rechts, positive y-Punkte nach oben und positive z-Punkte nach hinten zeigen.

Eigenschaft Dokumentation

masterVolume : real

Legt die Gesamtlautstärke fest oder gibt sie zurück, die zum Rendern des Schallfelds verwendet wird.


outputDevice : QtMultimedia.AudioDevice

Legt das Gerät fest oder gibt es zurück, das für die Ausgabe des Klangfelds verwendet wird.


outputMode : enumeration

Legt den aktuellen Ausgabemodus der Engine fest oder gibt ihn zurück.

Eigenschaft WertBeschreibung
SurroundOrdnet die Klänge der Lautsprecherkonfiguration des Ausgabegeräts zu. Dies ist normalerweise eine Stereo- oder Surround-Lautsprecherkonfiguration.
StereoOrdnet die Klänge der Stereo-Lautsprecherkonfiguration des Ausgabegeräts zu. Dabei werden zusätzliche Lautsprecher ignoriert und nur der linke und der rechte Kanal verwendet, um eine Stereowiedergabe des Klangfelds zu erzeugen.
KopfhörerVerwenden Sie die Spatialisierung für Kopfhörer, um einen 3D-Audioeffekt zu erzeugen, wenn Sie das Klangfeld über Kopfhörer hören.

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