QAmbientSound 类

立体声叠加声音。 更多...

头文件 #include <QAmbientSound>
CMakefind_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)
qmakeQT += spatialaudio
继承 QObject

公共类型

枚举Loops { Infinite, Once }

属性

公共函数

QAmbientSound(QAudioEngine *engine)
boolautoPlay() const
QAudioEngine *engine() const
intloops() const
voidsetAutoPlay(bool autoPlay)
voidsetLoops(int loops)
voidsetSource(const QUrl &url)
voidsetVolume(float volume)
QUrlsource() const
floatvolume() const

公共槽

void暂停()
void播放()
void停止()

信号

详细描述

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

成员类型文档

枚举 QAmbientSound::Loops

允许您使用以下值控制播放循环

常量描述
QAmbientSound::Infinite-1无限循环
QAmbientSound::Once1运行一次后停止播放

属性文档

autoPlay : bool

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

默认值是 true

访问函数

boolautoPlay() const
voidsetAutoPlay(bool autoPlay)

通知信号

voidautoPlayChanged()

loops : int

确定在播放器停止之前,音频播放的次数。设置为QAmbientSound::Infinite会循环播放当前音频。

默认值为1

访问函数

intloops() const
voidsetLoops(int loops)

通知信号

voidloopsChanged()

source : QUrl

播放音频的源文件。

访问函数

QUrlsource() const
voidsetSource(const QUrl &url)

通知信号

voidsourceChanged()

volume : float

定义音频的音量。

介于0到1之间的值将衰减音量,而大于1的值将提供额外的增益提升。

访问函数

floatvolume() const
voidsetVolume(float volume)

通知信号

voidvolumeChanged()

成员函数文档

[显式] QAmbientSound::QAmbientSound(QAudioEngine *engine)

engine创建一个立体声音源。

QAudioEngine *QAmbientSound::engine() const

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

[槽] void QAmbientSound::pause()

暂停音频播放。调用play()将恢复播放。

[槽] void QAmbientSound::play()

开始播放音频。如果音频已经在播放,则不会执行任何操作。

[槽] void QAmbientSound::stop()

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

© 2024 Qt公司有限公司。本文档中的文档贡献属于其各自的所有者。本处提供的文档是根据免费软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt和相应的徽标是芬兰的Qt公司或世界其他国家的商标。所有其他商标均为其各自所有者的财产。