PySide6.QtSpatialAudio#

详细说明#

Qt空间音频模块提供了在3D空间中对声音源及其周围进行建模的API。

Qt空间音频是一个附加模块,提供了一组丰富的QML类型和C++类,用于实现3D空间中的声场。它包含了一个易于使用的API来定位听者、添加围绕听者的本地化声音源,并用混响和反射模拟虚拟房间。

入门指南#

如果您是Qt空间音频的新用户,可以使用以下语句在您的.qml文件中导入QML类型。

要链接到C++库,请在您的项目CMakeLists.txt文件中添加以下内容。将my_project替换为您的项目名称。

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

空间音频概述提供了关于如何使用以下列出的不同类的更详细说明。

QML类型#

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

类型

描述

AudioEngine

处理音频场景的引擎

SpatialSound

位于3D空间中的声音源。

AmbientSound

与位置无关的立体声音轨。

AudioRoom

定义一个会产生音频混响和反射的房间。

C++类#

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

描述

QAudioEngine

处理音频场景的引擎

QSpatialSound

位于3D空间中的声音源。

QAmbientSound

与位置无关的立体声音轨。

QAudioRoom

定义一个会产生音频混响和反射的房间。

许可和归属#

Qt空间音频模块可在Qt公司提供的商业许可下获得。此外,它还可在免费软件许可下使用。这些免费软件许可包括GNU lesser通用公共许可证版本3或GNU通用公共许可证版本3。有关更多信息,请参阅Qt许可。

注意,Qt空间音频不在GNU通用公共许可证版本2下可用。

此外,Qt 6.7.0中的Qt空间音频包含以下许可的第三方模块

参考和示例#

类列表#