Qt Spatial Audio
Qt Spatial Audio befindet sich ein Zusatzmodul, das eine umfangreiche Sammlung von QML-Typen und C++-Klassen zur Implementierung von Klangfeldern im 3D-Raum bereitstellt. Es enthält eine benutzerfreundliche API, um einen Zuhörer im Raum zu positionieren, lokalisierte Klangquellen um den Zuhörer herum hinzuzufügen und virtuelle Räume mit Hall und Reflexionen zu emulieren.
Erste Schritte
Wenn Sie noch keine Erfahrung mit „ Qt Spatial Audio “ haben, können die QML-Typen mithilfe der folgenden Anweisung in Ihrer Datei „ .qml “ in eine Anwendung importiert werden.
import QtQuick3D.SpatialAudioUm eine Verknüpfung mit den C++-Bibliotheken herzustellen, fügen Sie Folgendes in die Datei „ CMakeLists.txt “ Ihres Projekts ein. Ersetzen Sie dabei „ mytarget “ durch den Namen Ihres Projekts.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)Die Übersicht über räumliches Audio enthält eine detailliertere Beschreibung zur Verwendung der unten aufgeführten Klassen.
QML-Typen
Die folgende Tabelle gibt einen Überblick über einige wichtige QML-Typen.
| Typ | Beschreibung |
|---|---|
| AudioEngine | Die Engine, die die Verarbeitung der Audioszene übernimmt |
| SpatialSound | Eine im 3D-Raum befindliche Klangquelle. |
| AmbientSound | Eine ortsunabhängige Stereo-Tonspur. |
| AudioRoom | Definiert einen Raum, der Hall und Reflexionen erzeugt. |
C++-Klassen
Die folgende Tabelle gibt einen Überblick über einige wichtige C++-Klassen
| Klasse | Beschreibung |
|---|---|
| QAudioEngine | Die Engine, die die Verarbeitung der Audioszene übernimmt |
| QSpatialSound | Eine im 3D-Raum befindliche Klangquelle. |
| QAmbientSound | Eine ortsunabhängige Stereo-Tonspur. |
| QAudioRoom | Definiert einen Raum, der Hall und Reflexionen erzeugt. |
Lizenzen und Namensnennungen
Das Modul „ Qt Spatial Audio “ ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter freien Softwarelizenzen verfügbar. Bei diesen freien Softwarelizenzen handelt es sich um die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 3. Weitere Informationen finden Sie unter Qt-Lizenzierung.
Beachten Sie, dass „ Qt Spatial Audio “ nicht unter der GNU General Public License, Version 2, verfügbar ist.
Darüber hinaus enthält „ Qt Spatial Audio “ in Qt 6.12.0 Module von Drittanbietern unter den folgenden freizügigen Lizenzen:
Mozilla Public License 2.0 und BSD 3-Clause „New“ oder „Revised“ License | |
Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553 | Apache-Lizenz 2.0 |
BSD-3-Klausel-„New“- oder „Revised“-Lizenz |
Referenz und Beispiele
© 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.
