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 シグナルは、statusプロパティが変更されたときに発火します。

[slot] void QSoundEffect::stop()

現在再生中のコンテンツを停止します。

[static] QStringList QSoundEffect::supportedMimeTypes()

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

float QSoundEffect::volume() const

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

関連項目： setVolume()。

[signal] void QSoundEffect::volumeChanged()

volumeChanged シグナルは、音量が変更されたときに発火します。