En esta página

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.

Reproductor de vídeo con superposición semitransparente

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

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 un FileDialog.
  • 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.

Panel de selección de escenas que muestra una lista de escenas de vídeo y del modo de cámara

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:

Frecuencia instantánea de 62,5 Hz y frecuencia media de 53,15 Hz

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()));

Proyecto de ejemplo en code.qt.io

© 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.