Qt Spatial Audio

Qt Spatial Audio 是一个附加模块,提供了丰富的 QML 类型和 C++ 类,用于在三维空间中实现声场。它包含一个易于使用的应用程序接口,用于在空间中定位听者,在听者周围添加局部声源,以及利用混响和反射模拟虚拟房间。

开始使用

如果您是Qt Spatial Audio 的新用户,可在.qml 文件中使用以下语句QML 类型导入应用程序。

import QtQuick3D.SpatialAudio

要与 C++ 库链接,请在项目的CMakeLists.txt 文件中添加以下语句。用项目名称代替my_project

find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)

空间音频概述》更详细地介绍了如何使用下面列出的不同类。

QML 类型

下表概述了一些重要的 QML 类型。

类型描述
AudioEngine处理音频场景的引擎
SpatialSound三维空间中的声源。
AmbientSound独立于位置的立体声音轨。
AudioRoom定义一个产生音频混响和反射的房间。

C++ 类

下表概述了一些重要的 C++ 类

描述
QAudioEngine处理音频场景的引擎
QSpatialSound三维空间中的声源
QAmbientSound独立于位置的立体声音轨。
QAudioRoom定义一个可产生音频混响和反射的房间。

许可和归属

Qt Spatial Audio 模块可在Qt XML 公司的商业许可下使用。此外,它还受自由软件许可证的保护。这些自由软件许可证是GNU Lesser General Public License 第 3 版GNU General Public License 第 3 版。更多详情,请参阅Qt 许可

请注意,Qt Spatial AudioGNU 通用公共许可证第 2 版下不可用。

此外,Qt 6.9.0 中的Qt Spatial Audio 包含以下许可协议下的第三方模块:

Eigen, version 3.4.0

Mozilla 公共许可证 2.0 和 BSD 3 条款 "新 "或 "修订 "许可证

Resonance Audio, version e225aedb5ec7

阿帕奇许可证 2.0

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

BSD 3 条款 "新 "或 "修订 "许可证

参考和示例

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