QSoundEffect Class

QSoundEffect effect;
effect.setSource(QUrl::fromLocalFile("engine.wav"));
effect.setLoopCount(QSoundEffect::Infinite);
effect.setVolume(0.25f);
effect.play();

MyGame()
    : m_explosion(this)
{
    m_explosion.setSource(QUrl::fromLocalFile("explosion.wav"));
    m_explosion.setVolume(0.25f);

    // Set up click handling etc.
    connect(clickSource, &QPushButton::clicked, &m_explosion, &QSoundEffect::play);
}
private:
QSoundEffect m_explosion;

成员函数 文档

[explicit] QSoundEffect::QSoundEffect(QObject *parent = nullptr)

使用给定的parent 创建 QSoundEffect。

[explicit] QSoundEffect::QSoundEffect(const QAudioDevice &audioDevice, QObject *parent = nullptr)

使用给定的audioDevice 和parent 创建 QSoundEffect。

[override virtual noexcept] QSoundEffect::~QSoundEffect()

破坏该音效。

bool QSoundEffect::isLoaded() const

返回音效是否已完成加载source() 。

bool QSoundEffect::isMuted() const

返回此音效是否静音

bool QSoundEffect::isPlaying() const

如果当前正在播放音效，则返回 true，否则返回 false

[signal] void QSoundEffect::loadedChanged()

当加载状态发生变化时，会发出loadedChanged 信号。

int QSoundEffect::loopCount() const

返回该音效在停止前的总播放次数。

有关当前剩余的循环次数，请参阅loopsRemaining() 方法。

另请参阅 setLoopCount() 方法。

[signal] void QSoundEffect::loopCountChanged()

loopCountChanged 信号会在初始循环数发生变化时发出。

[signal] void QSoundEffect::loopsRemainingChanged()

当剩余循环次数发生变化时，会发出loopsRemainingChanged 信号。

[signal] void QSoundEffect::mutedChanged()

当静音状态发生变化时，会发出mutedChanged 信号。

[slot] void QSoundEffect::play()

开始播放音效，循环播放循环属性中指定次数的音效。

[signal] void QSoundEffect::playingChanged()

当播放属性发生变化时，会发出playingChanged 信号。

void QSoundEffect::setLoopCount(int loopCount)

将播放该音效的总次数设置为loopCount 。

将循环次数设为 0 或 1 表示音效只播放一次；通过QSoundEffect::Infinite 则表示无限重复。循环次数可以在音效播放时更改，在这种情况下，它会将剩余的循环次数更新为新的loopCount 。

另请参阅 loopCount() 和loopsRemaining()。

void QSoundEffect::setMuted(bool muted)

设置是否使该音效的播放静音。

如果muted 为 true，重放将被静音（消音），否则重放将以当前指定的volume() 进行。

另请参阅 isMuted() 。

void QSoundEffect::setSource(const QUrl &url)

将当前要播放的 URL 设置为url 。

另请参阅 source() 。

void QSoundEffect::setVolume(float volume)

将音效音量设置为volume 。

音量从0.0 （静音）到1.0 （全音量）线性缩放。超出此范围的值将被箝位。

默认音量为1.0 。

用户界面音量控制通常应以非线性方式缩放。例如，使用对数刻度会使感知响度产生线性变化，而这正是用户通常期望从音量控制中获得的效果。更多详情，请参阅QtAudio::convertVolume() 。

另请参阅 volume() 。

QUrl QSoundEffect::source() const

返回当前播放源的 URL

另请参阅 setSource().

[signal] void QSoundEffect::sourceChanged()

sourceChanged 信号会在源被更改时发出。

QSoundEffect::Status QSoundEffect::status() const

返回此音效的当前状态。

[signal] void QSoundEffect::statusChanged()

当状态属性发生变化时，会发出statusChanged 信号。

[slot] void QSoundEffect::stop()

停止当前播放。

[static] QStringList QSoundEffect::supportedMimeTypes()

返回该平台支持的 MIME 类型列表。

float QSoundEffect::volume() const

返回此音效的当前音量，从 0.0（无声）到 1.0（最大音量）。

另请参阅 setVolume().

[signal] void QSoundEffect::volumeChanged()

volumeChanged 信号在音量发生变化时发出。