QSpatialSound Class

属性文档

autoPlay : bool

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

默认值为true 。

访问函数：

通知信号：

directivity : float

定义声源的方向性。值为 0 表示声音向各个方向均匀发射，而值为 1 表示声源主要向前方发射声音。

有效值范围为0到1，默认值为0。

访问函数：

通知信号：

directivityOrder : float

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

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

访问函数：

通知信号：

distanceCutoff : float

定义了声源发出的声音在超过该距离后将被截断。如果听者与声源的距离超过了截断距离，则将无法再听到该声音。

访问函数：

通知信号：

distanceModel : DistanceModel

定义该声源的距离模型。音量从size 开始逐渐降低至distanceCutoff 。当距离小于size时，音量保持恒定；当距离大于截止距离时，音量为零。

访问函数：

通知信号：

另请参阅 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 的数值则会提供额外的增益提升。

访问函数：

通知信号：