Video QML Type
Un tipo de conveniencia para reproducir un vídeo concreto. Más...
| Import Statement: | import QtMultimedia |
| Inherits: |
Propiedades
- autoPlay : bool
(since 6.7) - bufferProgress : real
- duration : int
- endOfStreamPolicy : enumeration
(since 6.9) - error : enumeration
- errorString : string
- fillMode : enumeration
- hasAudio : bool
- hasVideo : bool
- loops : int
- metaData : mediaMetaData
- mirrored : int
- muted : bool
- orientation : int
(since 6.9) - playbackRate : real
- playbackState : enumeration
- position : int
- seekable : bool
- source : url
- volume : real
Señales
- errorOccurred(error, errorString)
- paused()
- playing()
- stopped()
Métodos
- clearOutput()
(since 6.9) - pause()
- play()
- seek(offset)
- stop()
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:
| Constante | Descripción |
|---|---|
ClearOutput | Se borra la salida de vídeo. |
KeepLastFrame | La 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.