QSpatialSound Class

属性文档

autoPlay : bool

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

默认值为true 。

访问功能：

通知信号：

directivity : float

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

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

访问功能：

通知信号：

directivityOrder : float

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

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

访问功能：

通知信号：

distanceCutoff : float

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

访问功能：

通知信号：

distanceModel : DistanceModel

定义该声源的距离模型。音量从size 开始向下缩放至distanceCutoff 。距离小于尺寸时音量恒定，距离大于截止距离时音量为零。

访问功能：

通知信号：

另请参阅 QSpatialSound::DistanceModel 。

loops : int

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

默认值为1 。

访问功能：

通知信号：

manualAttenuation : float

如果distanceModel 设置为QSpatialSound::DistanceModel::ManualAttenuation ，则定义手动衰减因数。

访问功能：

提示信号：

nearFieldGain : float

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

访问功能：

提示信号：

occlusionIntensity : float

定义对象被遮挡的程度。0 表示物体完全没有被遮挡，1 表示声源完全被其他物体遮挡。

完全被遮蔽的物体仍然可以听到声音，但尤其是较高频率的声音会受到阻尼。此外，该物体仍会在室内产生混响和反射。

大于 1 的值可以进一步阻尼来自声源的直接声音。

默认值为 0。

访问功能：

通知信号：

position : QVector3D

定义声源在三维空间中的位置。默认单位为厘米。

访问功能：

通知信号：

另请参阅 QAudioEngine::distanceScale 。

rotation : QQuaternion

定义声源在三维空间中的方向。

访问功能：

提示信号：

size : float

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

访问功能：

通知信号：

source : QUrl

要播放的声音的源文件。

访问功能：

提示信号：

volume : float

定义声音的音量。

0 至 1 之间的数值会减弱声音，而 1 以上的数值则会提供额外的增益提升。

访问功能

Notifier 信号：