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;

Member Function Dokumentation

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

Erzeugt einen QSoundEffect mit der angegebenen parent.

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

Erzeugt einen QSoundEffect mit dem angegebenen audioDevice und parent.

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

Zerstört diesen Soundeffekt.

bool QSoundEffect::isLoaded() const

Gibt zurück, ob der Soundeffekt das Laden von source() abgeschlossen hat.

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 ausgesendet, wenn sich der Ladezustand geändert hat.

int QSoundEffect::loopCount() const

Gibt die Gesamtzahl der Wiederholungen dieses Soundeffekts zurück, bevor er gestoppt wird.

Siehe die Methode loopsRemaining() für die Anzahl der verbleibenden Schleifen.

Siehe auch setLoopCount().

[signal] void QSoundEffect::loopCountChanged()

Das Signal loopCountChanged wird ausgegeben, wenn sich die ursprüngliche Anzahl der Schleifen geändert hat.

[signal] void QSoundEffect::loopsRemainingChanged()

Das Signal loopsRemainingChanged wird ausgegeben, wenn sich die verbleibende Anzahl der Schleifen geändert hat.

[signal] void QSoundEffect::mutedChanged()

Das Signal mutedChanged wird ausgegeben, wenn sich der Zustand der Stummschaltung geändert hat.

[slot] void QSoundEffect::play()

Startet die Wiedergabe des Soundeffekts, wobei der Effekt so oft wiederholt wird, wie in der Eigenschaft loops angegeben.

[signal] void QSoundEffect::playingChanged()

Das Signal playingChanged wird ausgegeben, wenn sich die Abspieleigenschaft geändert hat.

void QSoundEffect::setLoopCount(int loopCount)

Stellen Sie die Gesamtzahl der Wiederholungen für diesen Soundeffekt auf loopCount ein.

Wenn Sie die Schleifenanzahl auf 0 oder 1 setzen, wird der Soundeffekt nur einmal abgespielt; geben Sie QSoundEffect::Infinite ein, um ihn unbegrenzt zu wiederholen. Die Anzahl der Schleifen kann während der Wiedergabe des Soundeffekts geändert werden. In diesem Fall werden die verbleibenden Schleifen auf die neue loopCount aktualisiert.

Siehe auch loopCount() und loopsRemaining().

void QSoundEffect::setMuted(bool muted)

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

Wenn muted true ist, wird die Wiedergabe stummgeschaltet, andernfalls erfolgt die Wiedergabe mit der aktuell angegebenen volume().

Siehe auch isMuted().

void QSoundEffect::setSource(const QUrl &url)

Setzen Sie die aktuelle URL zum Abspielen auf url.

Siehe auch source().

void QSoundEffect::setVolume(float volume)

Setzt die Lautstärke des Soundeffekts auf volume.

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

Die Standardlautstärke ist 1.0.

Die Lautstärkeregler der Benutzeroberfläche sollten normalerweise nicht linear skaliert werden. Die Verwendung einer logarithmischen Skala führt beispielsweise zu linearen Änderungen der wahrgenommenen Lautstärke, was der Benutzer normalerweise von einem Lautstärkeregler erwarten würde. Siehe QtAudio::convertVolume() für weitere Details.

Siehe auch volume().

QUrl QSoundEffect::source() const

Gibt die URL der aktuellen Quelle für die Wiedergabe zurück

Siehe auch setSource().

[signal] void QSoundEffect::sourceChanged()

Das Signal sourceChanged wird ausgesendet, 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 ausgesendet, wenn sich die Statuseigenschaft geändert hat.

[slot] void QSoundEffect::stop()

Aktuelle Wiedergabe stoppen.

[static] QStringList QSoundEffect::supportedMimeTypes()

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

float QSoundEffect::volume() const

Gibt die aktuelle Lautstärke dieses Soundeffekts zurück, von 0.0 (leise) bis 1.0 (maximale Lautstärke).

Siehe auch setVolume().

[signal] void QSoundEffect::volumeChanged()

Das Signal volumeChanged wird ausgegeben, wenn sich die Lautstärke geändert hat.