Ejemplo de vídeo en QML
Transformación del contenido de vídeo y del visor de la cámara.
El vídeo de QML muestra las diversas transformaciones (desplazamiento, cambio de tamaño, rotación y cambio de relación de aspecto) que se pueden aplicar a los tipos « VideoOutput » y « Camera » de QML.
También muestra cómo se puede combinar el código nativo con QML para implementar funcionalidades más avanzadas; en este caso, se utiliza código C++ para calcular la frecuencia de fotogramas de QML. Este valor se representa en QML mediante un elemento semitransparente superpuesto al contenido de vídeo.
La siguiente imagen muestra la aplicación ejecutando la escena de superposición de vídeo, que crea un elemento de superposición ficticio (simplemente un Rectangle semitransparente) que se desplaza sobre el elemento VideoOutput.

Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo Welcome y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Estructura de la aplicación
El archivo « Main.qml » crea una interfaz de usuario que incluye los siguientes elementos:
- Dos instancias de «
Button», cada una de las cuales muestra un nombre de archivo y puede utilizarse para iniciar unFileDialog. - Un «
Button» de salida. - Un «
SceneSelectionPanel», que es una lista en la que se puede deslizar el dedo y que muestra las escenas disponibles. - En la esquina inferior izquierda, un elemento que muestra la frecuencia de actualización de QML: el número superior es la frecuencia de fotogramas instantánea y el inferior es la media del último segundo.

Cada escena de la lista desplazable está implementada en su propio archivo QML; por ejemplo, la escena «video-basic» (que simplemente muestra un « VideoOutput » estático en el centro de la pantalla) está implementada en el archivo « VideoBasic.qml ». Como se puede ver en el código, esto utiliza un tipo de herencia: un elemento « VideoBasic »...
SceneBasic {
contentType: "video"
}... es de tipo SceneBasic...
import QtQuick
import QtQuick.Controls
Scene {
id: root
property string contentType
...
Content {
id: content
...
}
Label {
anchors {
horizontalCenter: parent.horizontalCenter
bottom: parent.bottom
margins: 20
}
text: content.started ? qsTr("Tap the screen to stop content")
: qsTr("Tap the screen to start content")
z: 2.0
}
MouseArea {
anchors.fill: parent
onClicked: {
if (content.started)
content.stop()
else
content.start()
}
}
Component.onCompleted: root.content = content
}... que a su vez es un Scene:
import QtQuick
import QtQuick.Controls
Rectangle {
id: root
...
property QtObject content
...
Button {
id: closeButton
anchors {
top: parent.top
right: parent.right
margins: root.margins
}
z: 2.0
text: qsTr("Back")
onClicked: root.close()
}
}SceneBasic describe la estructura y el comportamiento de la escena, pero es independiente del tipo de contenido que se mostrará; esto lo abstrae Content.
Este patrón nos permite definir un caso de uso concreto (en este caso, simplemente mostrar un fragmento de contenido estático) y, a continuación, instanciar ese caso de uso tanto para contenido de vídeo (VideoBasic) como para contenido de cámara ({CameraBasic}). Este enfoque se utiliza para implementar muchas de las demás escenas; por ejemplo, «deslizar repetidamente el contenido de izquierda a derecha y viceversa» se implementa mediante SceneMove, en el que se basan VideoMove y CameraMove.
Dependiendo del valor de la propiedad contentType en la instancia de la escena de nivel superior, el elemento incrustado Content crea un elemento MediaPlayer o un elemento Camera.
Cálculo y visualización de la frecuencia de actualización de QML
La tasa de actualización de QML se calcula mediante la clase FrequencyMonitor, que convierte un flujo de eventos (recibidos a través de la ranura notify()) en una frecuencia instantánea y una media:
class FrequencyMonitor : public QObject
{
Q_OBJECT
QML_ELEMENT
Q_PROPERTY(qreal instantaneousFrequency READ instantaneousFrequency NOTIFY
instantaneousFrequencyChanged)
Q_PROPERTY(qreal averageFrequency READ averageFrequency NOTIFY averageFrequencyChanged)
...
public slots:
Q_INVOKABLE void notify();
};La clase FrequencyMonitor se expone a QML añadiendo la macro QML_ELEMENT a la declaración de la clase, tal y como se muestra arriba, y sus datos se muestran definiendo un elemento QML llamado FrequencyItem, de la siguiente manera:
import frequencymonitor
Rectangle {
id: root
...
function notify() {
monitor.notify()
}
FrequencyMonitor {
id: monitor
onAverageFrequencyChanged: {
averageFrequencyText.text = monitor.averageFrequency.toFixed(2)
}
}
Text {
id: labelText
anchors {
left: parent.left
top: parent.top
margins: 10
}
color: root.textColor
font.pixelSize: 0.6 * root.textSize
text: root.label
width: root.width - 2*anchors.margins
elide: Text.ElideRight
}
Text {
id: averageFrequencyText
anchors {
right: parent.right
bottom: parent.bottom
margins: 10
}
color: root.textColor
font.pixelSize: root.textSize
}
}El resultado tiene este aspecto:

Solo queda conectar la señal afterRendering() del objeto QQuickView a una función de JavaScript, que finalmente llamará a frequencyItem.notify():
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
...
QQuickView viewer;
...
QQuickItem *rootObject = viewer.rootObject();
...
QObject::connect(&viewer, SIGNAL(afterRendering()), rootObject, SLOT(qmlFramePainted()));© 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.