空间声音 QML 类型

一个三维空间中的声音对象。更多...

导入语句	import QtQuick3D.SpatialAudio

属性

空间声音表示三维空间中的一个可听对象。您可以在空间中定义其位置和朝向，设置正在播放的声音并为对象定义音量。

对象可以具有不同的衰减行为，主要在一个方向或球面发声，并表现为被某些其他对象遮挡。

autoPlay : bool

确定是否在指定源时自动开始播放声音。

默认值是 true。

directivity : float

定义声音源的指向性。值为0表示声音在所有方向上均匀发射，而值为1表示源主要在正向方向上发射声音。

有效值在0到1之间，默认为0。

directivityOrder : float

定义声音源指向性的阶数。阶数越高，声音圆锥的定位越尖锐。

此属性的默认最小值是1。

distanceCutoff : float

定义距离值，在此距离之外来自源的声音将被截断。如果听者距离声音对象比截断距离更远，则声音将不再可闻。

distanceModel : enumeration

定义声音的音量是如何随着与听者的距离变化而缩放的。音量从大小开始缩放，直到距离截止值。在小于大小的距离下音量保持不变，在大于截止距离的距离下音量为零。

loops : int

确定声音播放多少次后播放器停止。设置为 SpatialSound::Infinite 以无限循环当前声音。

默认值为 1。

manualAttenuation : float

在 distanceModel 设置为 SpatialSound.ManualAttenuation 时定义手动衰减因子。

nearFieldGain : float

定义声音源的前场增益。有效值介于0和1之间。前场增益为1将在听者非常近的距离下将声音信号的音量增加约20 dB。

occlusionIntensity : float

定义物体的遮挡程度。0表示物体完全没有遮挡，而大的数字表示大的遮挡。

默认值是0。

size : float

定义声音源的大小。如果听者距离声音对象比大小更近，则音量将保持不变。大小也用于遮挡计算，其中大型源可以被墙壁部分遮挡。

source : url

要播放的声音的源文件。

volume : float

定义此声音源的总体音量。

介于0和1之间的值将衰减声音，而高于1的值将提供额外的增益提升。

暂停()

在当前位置暂停声音播放。调用 play() 将继续播放。

播放()

开始播放声音。如果声音已经在播放，则不执行任何操作。

停止()

停止声音播放并将当前位置和循环计数重置为0。调用 play() 将从声音文件的开始播放。