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;

Dokumentation der Mitgliedsfunktionen

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

Erstellt einen `QSoundEffect` mit dem angegebenen ` parent`.

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

Erstellt einen QSoundEffect mit den angegebenen Werten für „ audioDevice “ und „ parent “.

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

Löscht diesen Soundeffekt.

bool QSoundEffect::isLoaded() const

Gibt zurück, ob der Soundeffekt vollständig geladen wurde: ` source()`.

bool QSoundEffect::isMuted() const

Gibt zurück, ob dieser Soundeffekt stummgeschaltet ist

bool QSoundEffect::isPlaying() const

Gibt „true“ zurück, wenn der Soundeffekt gerade abgespielt wird, andernfalls „false“

[signal] void QSoundEffect::loadedChanged()

Das Signal „ loadedChanged “ wird ausgegeben, wenn sich der Ladezustand geändert hat.

int QSoundEffect::loopCount() const

Gibt die Gesamtanzahl der Wiedergaben dieses Soundeffekts zurück, bevor er beendet wird.

Informationen zur Anzahl der derzeit verbleibenden Wiederholungen finden Sie in der Methode „ loopsRemaining()“.

Siehe auch „ setLoopCount()“.

[signal] void QSoundEffect::loopCountChanged()

Das Signal „ loopCountChanged “ wird ausgelöst, wenn sich die anfängliche Anzahl der Schleifen geändert hat.

[signal] void QSoundEffect::loopsRemainingChanged()

Das Signal „ loopsRemainingChanged “ wird ausgelöst, wenn sich die Anzahl der verbleibenden Schleifen geändert hat.

[signal] void QSoundEffect::mutedChanged()

Das Signal „ mutedChanged “ wird ausgegeben, wenn sich der Stummschaltungsstatus geändert hat.

[slot] void QSoundEffect::play()

Starte die Wiedergabe des Soundeffekts und wiederhole den Effekt so oft, wie in der Eigenschaft „loops“ angegeben.

[signal] void QSoundEffect::playingChanged()

Das Signal „ playingChanged “ wird ausgelöst, wenn sich die Eigenschaft „playing“ geändert hat.

void QSoundEffect::setLoopCount(int loopCount)

Legen Sie die Gesamtanzahl der Wiedergaben dieses Soundeffekts auf „ loopCount “ fest.

Wenn die Schleifenanzahl auf 0 oder 1 gesetzt wird, wird der Soundeffekt nur einmal abgespielt; übergeben Sie „ QSoundEffect::Infinite “, um ihn unbegrenzt zu wiederholen. Die Schleifenanzahl kann während der Wiedergabe des Soundeffekts geändert werden. In diesem Fall wird die verbleibende Anzahl der Schleifen auf den neuen Wert „ loopCount “ aktualisiert.

Siehe auch „ loopCount()“ und „ loopsRemaining()“.

void QSoundEffect::setMuted(bool muted)

Legt fest, ob die Wiedergabe dieses Soundeffekts stummgeschaltet werden soll.

Ist ` muted ` auf `true` gesetzt, wird die Wiedergabe stummgeschaltet (unterdrückt); andernfalls erfolgt die Wiedergabe mit der aktuell festgelegten Lautstärke ` volume()`.

Siehe auch isMuted().

void QSoundEffect::setSource(const QUrl &url)

Lege die aktuell abzuspielende URL auf url fest.

Siehe auch „ source()“.

void QSoundEffect::setVolume(float volume)

Stellt die Lautstärke der Soundeffekte auf „ volume “ ein.

Die Lautstärke wird linear von 0.0 (Stille) bis 1.0 (volle Lautstärke) skaliert. Werte außerhalb dieses Bereichs werden begrenzt.

Die Standardlautstärke beträgt 1.0.

Lautstärkeregler in der Benutzeroberfläche sollten in der Regel nichtlinear skaliert werden. Die Verwendung einer logarithmischen Skala führt beispielsweise zu linearen Änderungen der wahrgenommenen Lautstärke, was ein Benutzer normalerweise von einem Lautstärkeregler erwartet. Weitere Details finden Sie unter ` QtAudio::convertVolume()`.

Siehe auch volume().

QUrl QSoundEffect::source() const

Gibt die URL der aktuell abzuspielenden Quelle zurück

Siehe auch „ setSource()“.

[signal] void QSoundEffect::sourceChanged()

Das Signal „ sourceChanged “ wird ausgelöst, wenn die Quelle geändert wurde.

QSoundEffect::Status QSoundEffect::status() const

Gibt den aktuellen Status dieses Soundeffekts zurück.

[signal] void QSoundEffect::statusChanged()

Das Signal „ statusChanged “ wird ausgelöst, wenn sich die Eigenschaft „status“ geändert hat.

[slot] void QSoundEffect::stop()

Die aktuelle Wiedergabe anhalten.

[static] QStringList QSoundEffect::supportedMimeTypes()

Gibt eine Liste der für diese Plattform unterstützten MIME-Typen zurück.

float QSoundEffect::volume() const

Gibt die aktuelle Lautstärke dieses Soundeffekts zurück, von 0,0 (stumm) bis 1,0 (maximale Lautstärke).

Siehe auch „ setVolume()“.

[signal] void QSoundEffect::volumeChanged()

Das Signal „ volumeChanged “ wird ausgelöst, wenn sich die Lautstärke geändert hat.