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;

Documentation des fonctions membres

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

Crée un objet `QSoundEffect` avec l'parent` indiquée.

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

Crée un objet `QSoundEffect` avec les paramètres ` audioDevice ` et ` parent` indiqués.

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

Supprime cet effet sonore.

bool QSoundEffect::isLoaded() const

Indique si le chargement de l'effet sonore est terminé à l'aide de la fonction ` source()`.

bool QSoundEffect::isMuted() const

Indique si cet effet sonore est désactivé

bool QSoundEffect::isPlaying() const

Renvoie « true » si l'effet sonore est en cours de lecture, ou « false » dans le cas contraire

[signal] void QSoundEffect::loadedChanged()

Le signal « loadedChanged » est émis lorsque l'état de chargement a changé.

int QSoundEffect::loopCount() const

Renvoie le nombre total de fois où cet effet sonore sera lu avant de s'arrêter.

Consultez la méthode loopsRemaining() pour connaître le nombre de boucles restantes.

Voir également setLoopCount().

[signal] void QSoundEffect::loopCountChanged()

Le signal « loopCountChanged » est émis lorsque le nombre initial de boucles a changé.

[signal] void QSoundEffect::loopsRemainingChanged()

Le signal « loopsRemainingChanged » est émis lorsque le nombre de boucles restantes a changé.

[signal] void QSoundEffect::mutedChanged()

Le signal « mutedChanged » est émis lorsque l'état de sourdine a changé.

[slot] void QSoundEffect::play()

Lance la lecture de l'effet sonore et le fait passer en boucle autant de fois que le spécifie la propriété « loops ».

[signal] void QSoundEffect::playingChanged()

Le signal « playingChanged » est émis lorsque la propriété « playing » a changé.

void QSoundEffect::setLoopCount(int loopCount)

Définissez le nombre total de lectures de cet effet sonore sur loopCount.

Si vous définissez le nombre de boucles sur 0 ou 1, l'effet sonore ne sera lu qu'une seule fois ; passez la valeur « QSoundEffect::Infinite » pour le répéter indéfiniment. Le nombre de boucles peut être modifié pendant la lecture de l'effet sonore ; dans ce cas, le nombre de boucles restantes sera mis à jour en fonction de la nouvelle valeur « loopCount ».

Voir également loopCount() et loopsRemaining().

void QSoundEffect::setMuted(bool muted)

Détermine s'il faut couper le son de cet effet sonore.

Si la valeur de « muted » est « true », la lecture sera mise en sourdine (silencieuse) ; dans le cas contraire, la lecture s'effectuera avec la valeur « volume » () actuellement spécifiée.

Voir également isMuted().

void QSoundEffect::setSource(const QUrl &url)

Définissez l'URL actuelle à lire sur url.

Voir également source().

void QSoundEffect::setVolume(float volume)

Règle le volume des effets sonores sur volume.

Le volume est modulé de manière linéaire entre 0.0 (silence) et 1.0 (volume maximal). Les valeurs situées en dehors de cette plage seront limitées.

Le volume par défaut est 1.0.

Les commandes de volume de l’interface utilisateur doivent généralement être mises à l’échelle de manière non linéaire. Par exemple, l’utilisation d’une échelle logarithmique produira des variations linéaires du niveau sonore perçu, ce à quoi un utilisateur s’attend normalement de la part d’une commande de volume. Voir QtAudio::convertVolume() pour plus de détails.

Voir également volume().

QUrl QSoundEffect::source() const

Renvoie l'URL de la source en cours de lecture

Voir aussi setSource().

[signal] void QSoundEffect::sourceChanged()

Le signal « sourceChanged » est émis lorsque la source a été modifiée.

QSoundEffect::Status QSoundEffect::status() const

Renvoie l'état actuel de cet effet sonore.

[signal] void QSoundEffect::statusChanged()

Le signal « statusChanged » est émis lorsque la propriété « status » a changé.

[slot] void QSoundEffect::stop()

Arrêter la lecture en cours.

[static] QStringList QSoundEffect::supportedMimeTypes()

Renvoie une liste des types MIME pris en charge par cette plateforme.

float QSoundEffect::volume() const

Renvoie le volume actuel de cet effet sonore, compris entre 0,0 (silence) et 1,0 (volume maximal).

Voir aussi : `setVolume()`

[signal] void QSoundEffect::volumeChanged()

Le signal « volumeChanged » est émis lorsque le volume a changé.