PySide6.QtSpatialAudio.QAmbientSound¶

class QAmbientSound¶

立体声叠加音效。更多…

概要¶

属性¶

• autoPlayᅟ

• loopsᅟ

• sourceᅟ

• volumeᅟ

方法¶

• def __init__()

• def autoPlay()

• def engine()

• def loops()

• def setAutoPlay()

• def setLoops()

• def setSource()

• def setVolume()

• def source()

• def volume()

插槽¶

• def pause()

• def play()

• def stop()

信号¶

• def autoPlayChanged()

• def loopsChanged()

• def sourceChanged()

• def volumeChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

QAmbientSound 表示一个位置和方向独立的声音。它通常用于背景声音（例如音乐），这些声音应该与听者的位置和方向无关。

class Loops¶

（继承自 enum.IntEnum）允许你使用以下值来控制播放循环：

常量	描述
QAmbientSound.Infinite	无限循环
QAmbientSound.Once	运行一次后停止播放

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property autoPlayᅟ: bool¶

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

默认值为 true。

Access functions:

• autoPlay()

• setAutoPlay()

• 信号 autoPlayChanged()

property loopsᅟ: int¶

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

默认值为1。

Access functions:

• loops()

• setLoops()

• 信号 loopsChanged()

property sourceᅟ: QUrl¶

要播放的声音的源文件。

Access functions:

• source()

• setSource()

• 信号 sourceChanged()

property volumeᅟ: float¶

定义声音的音量。

0到1之间的值会减弱声音，而大于1的值会提供额外的增益提升。

Access functions:

• volume()

• setVolume()

• 信号 volumeChanged()

__init__(engine)¶

Parameters:

引擎 – QAudioEngine

为engine创建一个立体声源。

autoPlay()¶

Return type:

布尔

另请参阅

setAutoPlay()

属性 autoPlayᅟ 的获取器。

autoPlayChanged()¶

属性 autoPlayᅟ 的通知信号。

engine()¶

Return type:

QAudioEngine

返回与此声音关联的引擎。

loops()¶

Return type:

整数

另请参阅

setLoops()

属性 loopsᅟ 的获取器。

loopsChanged()¶

属性 loopsᅟ 的通知信号。

pause()¶

暂停声音播放。调用 play() 将继续播放。

play()¶

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

setAutoPlay(autoPlay)¶

Parameters:

autoPlay – 布尔值

另请参阅

autoPlay()

属性 autoPlayᅟ 的设置器。

setLoops(loops)¶

Parameters:

循环次数 – int

另请参阅

loops()

属性 loopsᅟ 的设置器。

setSource(url)¶

Parameters:

url – QUrl

另请参阅

source()

属性 sourceᅟ 的设置器。

setVolume(volume)¶

Parameters:

volume – 浮点数

另请参阅

volume()

属性 volumeᅟ 的设置器。

source()¶

Return type:

QUrl

另请参阅

setSource()

属性 sourceᅟ 的获取器。

sourceChanged()¶

属性 sourceᅟ 的通知信号。

stop()¶

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

volume()¶

Return type:

浮点数

另请参阅

setVolume()

属性 volumeᅟ 的获取器。

volumeChanged()¶

属性 volumeᅟ 的通知信号。