En esta página

Video QML Type

Un tipo de conveniencia para reproducir un vídeo concreto. Más...

Import Statement: import QtMultimedia
Inherits:

Item

Propiedades

Señales

Métodos

Descripción detallada

Video es un tipo de conveniencia que combina en uno solo la funcionalidad de un ` MediaPlayer ` y un ` VideoOutput `. Proporciona una funcionalidad sencilla de reproducción de vídeo sin necesidad de declarar varios tipos.

A continuación se muestra un código de ejemplo para implementar la reproducción de vídeo en una escena.

Video {
    id: video
    width : 800
    height : 600
    source: "video.avi"

    MouseArea {
        anchors.fill: parent
        onClicked: {
            video.play()
        }
    }

    focus: true
    Keys.onSpacePressed: video.playbackState == MediaPlayer.PlayingState ? video.pause() : video.play()
    Keys.onLeftPressed: video.position = video.position - 5000
    Keys.onRightPressed: video.position = video.position + 5000
}

El archivo fuente, ` video.avi`, se reproduce al hacer clic en el elemento padre de ` MouseArea`. El vídeo se reproduce en un área de 800 por 600 píxeles, y su propiedad ` id ` tiene el valor «video».

Ten en cuenta que, dado que se han definido señales para Keys, al pulsar el botón:

  • Spacebar se activa el botón de pausa.
  • Left Arrow mueve la posición actual en el vídeo 5 segundos hacia atrás.
  • Right Arrow avanza la posición actual en el vídeo 5 segundos.

El vídeo admite la presentación sin transformar, estirada y escalada uniformemente. Para obtener una descripción de la presentación estirada y escalada uniformemente, consulta la descripción de la propiedad fillMode.

Véase también MediaPlayer y VideoOutput.

Documentación de propiedades

autoPlay : bool [since 6.7]

Esta propiedad controla si el contenido multimedia comienza a reproducirse automáticamente una vez cargado. El valor predeterminado es « false ».

Esta propiedad se introdujo en Qt 6.7.

bufferProgress : real

Esta propiedad indica en qué medida está lleno actualmente el búfer de datos, desde 0,0 (vacío) hasta 1,0 (lleno).

duration : int

Esta propiedad indica la duración del contenido multimedia en milisegundos.

Si el contenido multimedia no tiene una duración fija (por ejemplo, una retransmisión en directo), este valor será 0.

endOfStreamPolicy : enumeration [since 6.9]

Esta propiedad especifica la política que se aplicará cuando finalice la transmisión de vídeo.

La propiedad « endOfStreamPolicy » puede adoptar uno de los siguientes valores:

ConstanteDescripción
ClearOutputSe borra la salida de vídeo.
KeepLastFrameLa salida de vídeo sigue mostrando el último fotograma. Utilice el método clearOutput() para borrar la salida manualmente.

El valor por defecto es VideoOutput.ClearOutput.

Esta propiedad se introdujo en Qt 6.9.

error : enumeration

Esta propiedad contiene el estado de error del vídeo. Puede ser uno de los siguientes:

  • MediaPlayer.NoError: no hay ningún error actualmente.
  • MediaPlayer.ResourceError: no se puede reproducir el vídeo debido a un problema al asignar recursos.
  • MediaPlayer.FormatError: el formato del vídeo no es compatible.
  • MediaPlayer.NetworkError: no se puede reproducir el vídeo debido a problemas de red.
  • MediaPlayer.AccessDenied: no se puede reproducir el vídeo debido a permisos insuficientes.
  • MediaPlayer.ServiceMissing: no se puede reproducir el vídeo porque no se ha podido instanciar el servicio multimedia.

errorString : string

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

fillMode : enumeration

Configura esta propiedad para definir cómo se escala el vídeo para ajustarse al área de destino.

  • VideoOutput.Stretch: el vídeo se escala para ajustarse
  • VideoOutput.PreserveAspectFit: el vídeo se escala de manera uniforme para ajustarse sin recortarlo
  • VideoOutput.PreserveAspectCrop: el vídeo se escala uniformemente para llenar el área, recortándolo si es necesario

Dado que este tipo se utiliza por comodidad en QML, no admite enumeraciones directamente, por lo que se utilizan las enumeraciones de VideoOutput para acceder a los modos de relleno disponibles.

El modo de relleno predeterminado es «preserveAspectFit».

hasAudio : bool

Esta propiedad indica si el archivo multimedia actual contiene audio.

hasVideo : bool

Esta propiedad indica si el contenido multimedia actual contiene vídeo.

loops : int

Determina cuántas veces se reproduce el archivo multimedia antes de detenerse. Establece el valor en « MediaPlayer ». Si se establece en «Infinite», el archivo multimedia actual se reproducirá en bucle indefinidamente.

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

metaData : mediaMetaData

Esta propiedad contiene los metadatos del contenido multimedia actual.

Consulta MediaPlayer.metaData para obtener más detalles sobre cada clave de metadatos.

Véase también mediaMetaData.

mirrored : int

Determina si el vídeo mostrado se refleja simétricamente respecto a su eje vertical. El reflejo se aplica después de « orientation ». El valor por defecto es « false ».

muted : bool

Esta propiedad se mantiene independientemente de si el sonido está silenciado.

orientation : int [since 6.9]

Esta propiedad determina el ángulo, en grados, en el que se gira el vídeo mostrado en el sentido de las agujas del reloj en las coordenadas del vídeo, donde el eje Y apunta hacia abajo en la pantalla. La transformación de orientación se aplica antes de ` mirrored`.

Solo se admiten múltiplos de 90 grados, es decir, 0, 90, -90, 180, 270, etc.; de lo contrario, se ignora el valor especificado.

El valor por defecto es 0.

Esta propiedad se introdujo en Qt 6.9.

playbackRate : real

Esta propiedad establece la velocidad de reproducción del vídeo como un múltiplo de la velocidad normal.

playbackState : enumeration

Esta propiedad de solo lectura indica el estado de reproducción del contenido multimedia.

  • MediaPlayer.PlayingState: el contenido multimedia se está reproduciendo
  • MediaPlayer.PausedState: el contenido multimedia está en pausa
  • MediaPlayer.StoppedState: el contenido multimedia está detenido

El estado predeterminado es MediaPlayer.StoppedState.

position : int

Esta propiedad almacena la posición actual de reproducción en milisegundos.

seekable : bool

Esta propiedad indica si se puede cambiar la posición de reproducción del vídeo.

Si el valor es «true», al llamar al método ` seek()` o al modificar la propiedad ` position `, la reproducción se desplazará a la nueva posición.

source : url

Esta propiedad contiene la URL de origen del archivo multimedia.

volume : real

Esta propiedad controla el volumen del audio.

El volumen se escala linealmente desde 0.0 (silencio) hasta 1.0 (volumen máximo). Los valores fuera de este rango se limitarán.

El volumen por defecto es 1.0.

Los controles de volumen de la interfaz de usuario suelen escalarse de forma no lineal. Por ejemplo, el uso de 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. Consulta QtAudio::convertVolume() para obtener más detalles.

Documentación de Signal

errorOccurred(error, errorString)

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

Nota: El gestor correspondiente es onErrorOccurred.

paused()

Esta señal se emite cuando se detiene la reproducción.

Nota: El controlador correspondiente es onPaused.

playing()

Esta señal se emite cuando se inicia o se reanuda la reproducción.

Nota: El controlador correspondiente es onPlaying.

stopped()

Esta señal se emite cuando se detiene la reproducción.

Nota: El controlador correspondiente es onStopped.

Documentación del método

[since 6.9] clearOutput()

Borra la salida de vídeo eliminando el fotograma de vídeo actual. Se recomienda utilizar este método cuando sea necesario eliminar el último fotograma de vídeo una vez finalizada la transmisión de vídeo, con la propiedad « endOfStreamPolicy » del vídeo establecida en « KeepLastFrame ».

Este método se introdujo en Qt 6.9.

pause()

Pone en pausa la reproducción del contenido multimedia.

play()

Inicia la reproducción del contenido multimedia.

seek(offset)

Si la propiedad « seekable » tiene el valor «true», la posición de reproducción actual se desplaza a « offset ».

Véase también seekable y position.

stop()

Detiene la reproducción del contenido multimedia.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.