MediaPlayer QML Type

Añade reproducción multimedia a una escena. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• activeAudioTrack : int
• activeSubtitleTrack : int
• activeVideoTrack : int
• audioBufferOutput : QAudioBufferOutput (since 6.8)
• audioOutput : AudioOutput
• audioTracks : list<mediaMetaData>
• autoPlay : bool (since 6.7)
• bufferProgress : real
• duration : int
• error : enumeration
• errorString : string
• hasAudio : bool
• hasVideo : bool
• loops : int
• mediaStatus : enumeration
• metaData : mediaMetaData
• pitchCompensation : bool (since 6.10)
• pitchCompensationAvailability : enumeration (since 6.10)
• playbackOptions : playbackOptions (since 6.10)
• playbackRate : real
• playbackState : enumeration
• playing : bool (since 6.5)
• position : int
• seekable : bool
• source : url
• subtitleTracks : list<mediaMetaData>
• videoOutput : VideoOutput
• videoTracks : list<mediaMetaData>

Señales

• errorOccurred(error, errorString)
• playbackStateChanged()
• playingChanged()

Métodos

• void pause()
• void play()
• void stop()

Descripción detallada

Text {
    text: "Click Me!";
    font.pointSize: 24;
    width: 150; height: 50;

    MediaPlayer {
        id: playMusic
        source: "music.wav"
        audioOutput: AudioOutput {}
    }
    MouseArea {
        anchors.fill: parent
        onPressed:  { playMusic.play() }
    }
}

Puede utilizar MediaPlayer junto con un MultiMedia::AudioOutput para reproducir contenido de audio, o puede utilizarlo junto con un Multimedia::VideoOutput para reproducir vídeo.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "groovy_video.mp4"
        audioOutput: AudioOutput {}
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

Véase también AudioOutput y VideoOutput.

Documentación de propiedades

activeAudioTrack : int

Esta propiedad contiene el número de pista de la pista de audio actualmente activa. Establezca -1 para desactivar la pista de audio.

El valor por defecto de la propiedad es 0: la primera pista de audio.

activeSubtitleTrack : int

Esta propiedad contiene el número de pista de la pista de subtítulos actualmente activa. Establezca -1 para desactivar la pista de subtítulos.

El valor por defecto de la propiedad es -1: no hay subtítulos activos.

activeVideoTrack : int

Esta propiedad contiene el número de pista de la pista de audio de vídeo actualmente activa. Establezca -1 para desactivar la pista de vídeo.

El valor por defecto de la propiedad es 0: la primera pista de vídeo.

audioBufferOutput : QAudioBufferOutput [since 6.8]

Esta propiedad contiene la salida del búfer de audio de destino.

El uso normal de MediaPlayer desde QML no debería requerir el uso de esta propiedad.

Esta propiedad se introdujo en Qt 6.8.

Véase también QMediaPlayer::audioBufferOutput().

audioOutput : AudioOutput

Esta propiedad contiene la salida de audio de destino. Acepta un elemento AudioOutput.

Véase también QMediaPlayer::setAudioOutput().

audioTracks : list<mediaMetaData> [read-only]

Esta propiedad contiene una lista de metadatos. Cada índice se refiere a una pista de audio.

Los metadatos contienen propiedades que describen las pistas individuales. Para las pistas de audio, Language suele ser la propiedad más importante.

Véase también mediaMetaData.

autoPlay : bool [since 6.7]

Esta propiedad controla si el medio comienza a reproducirse automáticamente después de ser cargado. Por defecto es false.

Esta propiedad se introdujo en Qt 6.7.

bufferProgress : real [read-only]

Esta propiedad indica el nivel de llenado actual del búfer de datos, desde 0.0 (vacío) hasta 1.0 (lleno).

La reproducción sólo puede comenzar o reanudarse cuando la memoria está completamente llena. Cuando el búfer está lleno, MediaPlayer.Buffered es verdadero. Cuando el progreso de la memoria intermedia se encuentra entre 0.0 y 1.0, MediaPlayer.Buffering se establece en true.

Un valor inferior a 1.0 implica que la propiedad MediaPlayer.StalledMedia es true.

Véase también mediaStatus.

duration : int [read-only]

Esta propiedad contiene la duración del medio en milisegundos.

Si el medio no tiene una duración fija (una transmisión en directo, por ejemplo), se establecerá en 0.

error : enumeration [read-only]

Esta propiedad contiene el estado de error del audio. Puede ser uno de los siguientes

errorString : string [read-only]

Esta propiedad contiene una cadena que describe con más detalle la condición de error actual.

hasAudio : bool [read-only]

Esta propiedad indica si el medio contiene audio.

hasVideo : bool [read-only]

Esta propiedad indica si el medio contiene vídeo.

loops : int

Determina la frecuencia de reproducción del medio antes de que el reproductor se detenga. Establézcalo a MediaPlayer::Infinite para reproducir en bucle el archivo multimedia actual para siempre.

El valor por defecto es 1. Establecer esta propiedad a 0 no tiene ningún efecto.

mediaStatus : enumeration [read-only]

Esta propiedad contiene el estado de carga de los medios. Puede ser uno de los siguientes

metaData : mediaMetaData [read-only]

Devuelve los metadatos del medio actual utilizado por el reproductor multimedia.

Los metadatos pueden contener información como el título del vídeo o su fecha de creación.

pitchCompensation : bool [since 6.10]

Esta propiedad indica si la compensación de tono está activada.

Esta propiedad se introdujo en Qt 6.10.

pitchCompensationAvailability : enumeration [read-only, since 6.10]

Indica la disponibilidad de la compensación de cabeceo de MediaPlayer en el backend actual. La enumeración PitchCompensationAvailability tiene alcance.

Esta propiedad se introdujo en Qt 6.10.

playbackOptions : playbackOptions [since 6.10]

Esta propiedad expone la API playbackOptions que ofrece un control de bajo nivel de las opciones de reproducción multimedia. Aunque recomendamos encarecidamente confiar en la configuración predeterminada de MediaPlayer, esta API se puede utilizar para optimizar la reproducción multimedia en casos de uso específicos en los que las opciones predeterminadas no son las ideales.

Las opciones de reproducción tendrán efecto la próxima vez que se cambie MediaPlayer::source.

Esta propiedad se introdujo en Qt 6.10.

playbackRate : real

Esta propiedad contiene la velocidad a la que se reproducen los medios como múltiplo de la velocidad normal.

Para más información, consulte QMediaPlayer::playbackRate.

Por defecto es 1.0.

playbackState : enumeration [read-only]

Esta propiedad contiene el estado de la reproducción multimedia. Puede ser uno de los siguientes:

playing : bool [read-only, since 6.5]

Indica si el medio se está reproduciendo actualmente.

Esta propiedad se introdujo en Qt 6.5.

Véase también playbackState.

position : int

El valor es la posición de reproducción actual, expresada en milisegundos desde el inicio del medio. Los cambios periódicos en la posición se indicarán con la señal positionChanged().

Si la propiedad seekable es verdadera, esta propiedad puede establecerse en milisegundos.

seekable : bool [read-only]

Esta propiedad indica si se puede cambiar la dirección position del soporte.

source : url

Esta propiedad contiene la URL de origen del medio.

Item {
    MediaPlayer {
        id: mediaplayer
        source: "file:///test.mp4"
        videoOutput: videoOutput
        audioOutput: AudioOutput {

        }
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }

    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed: mediaplayer.play();
    }
}

Véase también QMediaPlayer::setSource().

subtitleTracks : list<mediaMetaData> [read-only]

Esta propiedad contiene una lista de metadatos. Cada índice se refiere a una pista de subtítulos.

Los metadatos contienen propiedades que describen las pistas individuales. Para las pistas de subtítulos, Language suele ser la propiedad más importante.

Véase también mediaMetaData.

videoOutput : VideoOutput

Esta propiedad contiene la salida de vídeo de destino. Acepta un elemento VideoOutput.

Véase también QMediaPlayer::setVideoOutput().

videoTracks : list<mediaMetaData> [read-only]

Esta propiedad contiene una lista de metadatos. Cada índice se refiere a una pista de vídeo.

Los metadatos contienen propiedades que describen las pistas individuales.

Véase también mediaMetaData.

Documentación de la señal

errorOccurred(error, errorString)

Esta señal se emite cuando se ha producido un error. El parámetro errorString puede contener información más detallada sobre el error.

Véase también QMediaPlayer::Error.

playbackStateChanged()

Esta señal se emite cuando se modifica la propiedad playbackState.

playingChanged()

Esta señal se emite cuando cambia la propiedad playing.

Documentación del método

void pause()

Pausa la reproducción del medio.

Establece la propiedad playbackState en PausedState y cambia playing a false.

void play()

Inicia o reanuda la reproducción del medio.

Establece la propiedad playbackState a PlayingState, y cambia playing a true.

void stop()

Detiene la reproducción del medio.

Establece la propiedad playbackState en StoppedState y cambia playing a false.