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

サウンドエフェクトの再生を開始し、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 が true の場合、再生はミュート（消音）され、そうでない場合は、現在指定されている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 シグナルは、ステータスプロパティが変更されたときに発せられる。

[slot] void QSoundEffect::stop()

現在の再生を停止する。

[static] QStringList QSoundEffect::supportedMimeTypes()

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

float QSoundEffect::volume() const

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

setVolume()も参照してください 。

[signal] void QSoundEffect::volumeChanged()

volumeChanged シグナルは、音量が変化したときに発せられる。