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 を作成します。

[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()

効果音の再生を開始し、loopsプロパティで指定された回数だけ効果音をループさせる。

[signal] void QSoundEffect::playingChanged()

再生プロパティが変更されると、playingChanged シグナルが発信される。

void QSoundEffect::setLoopCount(int loopCount)

この効果音の総再生回数をloopCount に設定します。

ループカウントを0または1に設定すると、効果音は1回だけ再生されます。QSoundEffect::Infinite を渡すと、無限に繰り返します。効果音の再生中にループ回数を変更することも可能で、その場合は残りのループが新しいloopCount に更新されます。

loopCount() およびloopsRemaining()も参照 。

void QSoundEffect::setMuted(bool muted)

このサウンドエフェクトの再生をミュートするかどうかを設定します。

muted が真の場合、再生はミュート（消音）され、そうでない場合は、現在指定されているvolume() で再生されます。

isMuted()も参照 。

void QSoundEffect::setSource(const QUrl &url)

再生する現在の URL をurl に設定する。

source()も参照 。

void QSoundEffect::setVolume(float volume)

効果音の音量をvolume に設定する。

音量は、0.0 （無音）から1.0 （フル音量）まで線形にスケーリングされます。この範囲外の値はクランプされます。

デフォルトの音量は1.0 です。

UIの音量コントロールは通常、非線形にスケーリングされるべきです。例えば、対数スケールを使用すると、知覚されるラウドネスが直線的に変化します。詳細はQtAudio::convertVolume() を参照。

volume()も参照 。

QUrl QSoundEffect::source() const

現在再生しているソースの URL を返す。

setSource()も参照 。

[signal] void QSoundEffect::sourceChanged()

sourceChanged シグナルは、ソースが変更されたときに発せられる。

QSoundEffect::Status QSoundEffect::status() const

この効果音の現在の状態を返す。

[signal] void QSoundEffect::statusChanged()

statusChanged シグナルは、status プロパティが変更された時に発せられる。

[slot] void QSoundEffect::stop()

現在の再生を停止する。

[static] QStringList QSoundEffect::supportedMimeTypes()

このプラットフォームでサポートされている MIME タイプのリストを返す。

float QSoundEffect::volume() const

現在の効果音の音量を、0.0（無音）から 1.0（最大音量）の範囲で返します。

setVolume()も参照のこと 。

[signal] void QSoundEffect::volumeChanged()

音量が変更されると、volumeChanged シグナルが発信される。