AudioEngine QML Type

AudioEngine 管理 3D 场景中的声音对象。更多...

• 所有成员列表（包括继承的成员）

属性

• distanceScale : real (since 6.11)
• masterVolume : real
• outputDevice : QtMultimedia.AudioDevice
• outputMode : enumeration

详细说明

AudioEngine 负责管理 3D 场景中的声音对象。您可以向场景中添加“SpatialSound ”对象，以定义在 3D 空间中指定位置发出的声音。AmbientSound 允许您添加立体声叠加层（例如旁白或配乐）。

您可以使用AudioListener 来定义聆听者相对于声源在声场中的位置。 听者距离声源越远，声源的声音就越难以听清。此外，声音还会根据听者与声源之间的方向，被映射到相应的扬声器上。在许多情况下，AudioListener 对象可以直接作为QtQuick3D.Camera对象的子对象进行实例化。

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

AudioEngine 确实提供了一种模式，其中 Qt 通过头相关脉冲响应函数（参见 https://en.wikipedia.org/wiki/Sound_localization）模拟耳朵的效果，以便在使用耳机时在 3D 空间中定位声音，并通过耳机营造空间音频效果。

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

属性文档

distanceScale : real [since 6.11]

定义空间音频引擎所用坐标系的比例尺。默认情况下，所有单位均为厘米，这与Qt Quick 3D 使用的默认单位一致。

将距离比例设置为 100 可将单位转换为米。

该属性自 Qt 6.11 起引入。

masterVolume : real

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

outputDevice : QtMultimedia.AudioDevice

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

outputMode : enumeration

设置或获取引擎的当前输出模式。