AudioEngine QML Type

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

Import Statement: import QtQuick3D.SpatialAudio

属性

详细说明

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 向后。

属性文档

masterVolume : real

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


outputDevice : QtMultimedia.AudioDevice

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


outputMode : enumeration

设置或返回引擎的当前输出模式。

属性值说明
环绕声将声音映射到输出设备的扬声器配置。通常是立体声或环绕声扬声器设置。
立体声将声音映射到输出设备的立体声扬声器配置。这将忽略任何额外的扬声器,仅使用左右声道创建立体声声场。
耳机通过耳机聆听声场时,使用耳机空间化创建 3D 音频效果。

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