Qt Spatial Audio
Qt Spatial Audio ist ein Zusatzmodul, das einen umfangreichen Satz von QML-Typen und C++-Klassen zur Implementierung von Schallfeldern im 3D-Raum bietet. Es enthält eine einfach zu verwendende API, um einen Hörer im Raum zu positionieren, lokalisierte Schallquellen um den Hörer herum hinzuzufügen und virtuelle Räume mit Hall und Reflexionen zu emulieren.
Erste Schritte
Wenn Sie neu bei Qt Spatial Audio sind, können Sie die QML-Typen mit der folgenden Anweisung in Ihrer .qml -Datei in eine Anwendung importieren.
import QtQuick3D.SpatialAudio
Um gegen die C++-Bibliotheken zu linken, fügen Sie die folgende Anweisung in die Datei CMakeLists.txt Ihres Projekts ein. Ersetzen Sie my_project durch den Namen Ihres Projekts.
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)Spatial Audio Overview bietet eine detailliertere Beschreibung der Verwendung der verschiedenen unten aufgeführten Klassen.
QML-Typen
In der folgenden Tabelle sind einige wichtige QML-Typen aufgeführt.
| Typ | Beschreibung |
|---|---|
| AudioEngine | Die Engine, die für die Verarbeitung der Audioszene zuständig ist |
| SpatialSound | Eine Klangquelle, die sich im 3D-Raum befindet. |
| AmbientSound | Eine ortsunabhängige Stereo-Soundspur. |
| AudioRoom | Definiert einen Raum, der Audio-Hall und -Reflexionen erzeugt. |
C++-Klassen
In der folgenden Tabelle sind einige wichtige C++-Klassen aufgeführt
| Klasse | Beschreibung |
|---|---|
| QAudioEngine | Die Engine, die die Audioszene verarbeitet |
| QSpatialSound | Eine im 3D-Raum befindliche Klangquelle. |
| QAmbientSound | Eine ortsunabhängige Stereo-Tonspur. |
| QAudioRoom | Definiert einen Raum, der Audio-Hall und -Reflexionen erzeugt. |
Lizenzen und Namensnennung
Das Modul Qt Spatial Audio ist unter kommerziellen Lizenzen von The Qt Company erhältlich. Darüber hinaus ist es unter Lizenzen für freie Software erhältlich. Diese Lizenzen für freie Software sind die GNU Lesser General Public License, Version 3, oder die GNU General Public License, Version 3. Siehe Qt-Lizenzierung für weitere Details.
Beachten Sie, dass Qt Spatial Audio nicht unter der GNU General Public License, Version 2, verfügbar ist.
Außerdem enthält Qt Spatial Audio in Qt 6.8.2 Module von Drittanbietern, die unter den folgenden Lizenzen stehen:
Mozilla Public License 2.0 und BSD 3-Klausel "New" oder "Revised" Lizenz | |
Apache-Lizenz 2.0 | |
BSD 3-Klausel "Neue" oder "Revidierte" Lizenz |
Referenz und Beispiele
© 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.
