SpatialSound QML Type

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

默认值为true 。

定义声源的指向性。值为 0 意味着声音向所有方向均等地发出，而值为 1 则意味着声源主要向前方发出声音。

有效值介于 0 和 1 之间，默认值为 0。

定义声源指向性的阶数。阶数越高，声锥的定位越清晰。

该属性的最小值和默认值均为 1。

定义声源发出声音的距离。如果聆听者与声音对象的距离超过了截止距离，声音将不再可闻。

定义声音的音量如何随与聆听者的距离缩放。音量从size 开始向下缩放至distanceCutoff 。当距离小于 size 时，音量保持不变；当距离大于截止距离时，音量为零。

决定播放器停止播放声音的频率。设置为 SpatialSound::Infinite 时，将永远循环播放当前声音。

默认值为1 。

如果distanceModel 设置为SpatialSound.ManualAttenuation，则定义手动衰减因子。

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

定义物体被遮挡的程度。0 表示物体完全未被遮蔽，而大数值则表示物体被大量遮蔽。

默认值为 0。

定义声源的大小。如果聆听者与声音对象的距离大于尺寸，音量将保持不变。该尺寸也用于计算声源闭塞情况，在这种情况下，大的声源可能会被墙壁部分闭塞。

要播放声音的源文件。

定义音源的总音量。

介于 0 和 1 之间的数值会减弱声音，而高于 1 的数值则会提供额外的增益提升。

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

开始播放声音。如果声音已在播放，则不起任何作用。

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