音频引擎 QML 类型

音频引擎管理 3D 场景中的声音对象。更多信息...

导入语句	import QtQuick3D.SpatialAudio

属性

音频引擎管理 3D 场景中的声音对象。您可以向场景添加 SpatialSound 对象，以定义在 3D 空间中特定位置发生的声音。通过 AmbientSound，您可以添加立体声叠加（例如旁白或音轨）。

您可以使用 AudioListener 定义相对于声音源的人听声音场的位置。如果听者离源更远，声音源将更不明显。它们还将根据听者和源之间的方向映射到相应的扬声器。在许多情况下，AudioListener 对象可以简单地作为 QtQuick3D 摄像机对象的子对象实例化。

创建模拟具有特定尺寸和不同类型墙壁的房间声音（反射和混响）的 AudioRoom 对象。

音频引擎确实提供了一个模式，其中 Qt 使用头相关冲击响应函数模拟耳朵的效果（也可参见 https://en.wikipedia.org/wiki/Sound_localization）来在耳机中使用时将声音定位在 3D 空间中，并通过耳机创建空间音频效果。

与其他 Qt Quick 3D 一样，音频引擎默认使用厘米为单位坐标系。坐标轴的定义是，正 x 指向右，正 y 指向上，正 z 指向后。

masterVolume : float

设置或返回用于渲染声音场的总音量。

outputDevice : QtMultimedia.AudioDevice

设置或返回用于输出声音场的设备。

outputMode : 枚举

设置或检索引擎当前输出模式。

属性值	描述
环绕	将声音映射到输出设备的扬声器配置。这通常是立体声或环绕扬声器设置。
立体声	将声音映射到输出设备的立体声扬声器配置。这将忽略任何附加的扬声器，并仅使用左右声道创建声音场的立体声渲染。
耳机	使用耳机空间化功能，通过耳机收听声场时创建3D音频效果。