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;

Documentación de funciones miembro

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

Crea un QSoundEffect con la dirección parent.

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

Crea un QSoundEffect con los datos audioDevice y parent.

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

Destruye este efecto de sonido.

bool QSoundEffect::isLoaded() const

Devuelve si el efecto de sonido ha terminado de cargar source().

bool QSoundEffect::isMuted() const

Devuelve si este efecto de sonido está silenciado

bool QSoundEffect::isPlaying() const

Devuelve true si el efecto de sonido se está reproduciendo actualmente, o false en caso contrario

[signal] void QSoundEffect::loadedChanged()

La señal loadedChanged se emite cuando el estado de carga ha cambiado.

int QSoundEffect::loopCount() const

Devuelve el número total de veces que se reproducirá este efecto de sonido antes de detenerse.

Consulte el método loopsRemaining() para conocer el número de bucles restantes.

Véase también setLoopCount().

[signal] void QSoundEffect::loopCountChanged()

La señal loopCountChanged se emite cuando el número inicial de bucles ha cambiado.

[signal] void QSoundEffect::loopsRemainingChanged()

La señal loopsRemainingChanged se emite cuando el número restante de bucles ha cambiado.

[signal] void QSoundEffect::mutedChanged()

La señal mutedChanged se emite cuando el estado de silencio ha cambiado.

[slot] void QSoundEffect::play()

Inicia la reproducción del efecto de sonido, reproduciéndolo en bucle el número de veces especificado en la propiedad loops.

[signal] void QSoundEffect::playingChanged()

La señal playingChanged se emite cuando la propiedad de reproducción ha cambiado.

void QSoundEffect::setLoopCount(int loopCount)

Establece el número total de veces que se reproducirá este efecto de sonido en loopCount.

Establecer el recuento de bucles en 0 o 1 significa que el efecto de sonido se reproducirá sólo una vez; pasa QSoundEffect::Infinite para que se repita indefinidamente. La cuenta de bucles puede cambiarse mientras se reproduce el efecto de sonido, en cuyo caso actualizará los bucles restantes al nuevo loopCount.

Véase también loopCount() y loopsRemaining().

void QSoundEffect::setMuted(bool muted)

Establece si se silencia la reproducción de este efecto de sonido.

Si muted es verdadero, la reproducción será silenciada (muteada), y en caso contrario la reproducción se producirá con el valor actualmente especificado volume().

Véase también isMuted().

void QSoundEffect::setSource(const QUrl &url)

Establece la URL actual a reproducir en url.

Véase también source().

void QSoundEffect::setVolume(float volume)

Establece el volumen del efecto de sonido en volume.

El volumen se escala linealmente de 0.0 (silencio) a 1.0 (volumen máximo). Los valores que queden fuera de este rango se bloquearán.

El volumen por defecto es 1.0.

Normalmente, los controles de volumen de la interfaz de usuario deben escalarse de forma no lineal. Por ejemplo, utilizar una escala logarítmica producirá cambios lineales en el volumen percibido, que es lo que un usuario esperaría normalmente de un control de volumen. Consulte QtAudio::convertVolume() para obtener más información.

Véase también volume().

QUrl QSoundEffect::source() const

Devuelve la URL de la fuente actual a reproducir

Véase también setSource().

[signal] void QSoundEffect::sourceChanged()

La señal sourceChanged se emite cuando se ha cambiado la fuente.

QSoundEffect::Status QSoundEffect::status() const

Devuelve el estado actual de este efecto de sonido.

[signal] void QSoundEffect::statusChanged()

La señal statusChanged se emite cuando la propiedad de estado ha cambiado.

[slot] void QSoundEffect::stop()

Detener la reproducción actual.

[static] QStringList QSoundEffect::supportedMimeTypes()

Devuelve una lista de los tipos mime soportados para esta plataforma.

float QSoundEffect::volume() const

Devuelve el volumen actual de este efecto de sonido, de 0.0 (silencio) a 1.0 (volumen máximo).

Véase también setVolume().

[signal] void QSoundEffect::volumeChanged()

La señal volumeChanged se emite cuando el volumen ha cambiado.