En esta página

Reproductor multimedia SCXML

Envía y recibe datos desde un modelo de datos en C++.

Reproductor multimedia con la lista de canciones a la izquierda y el estado «Detenido» a la derecha

Media Player muestra cómo acceder a los datos de un modelo de datos de C++. El modelo de datos permite escribir código en C++ para los atributos «expr» y los elementos « <script> ». La parte de datos del modelo está respaldada por una subclase de « QScxmlCppDataModel », para la cual el compilador « Qt SCXML » (qscxmlc) genera los métodos de despacho.

La interfaz de usuario se crea utilizando Qt Quick.

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Uso del modelo de datos de C++

Especificamos el modelo de datos como valor del atributo ` datamodel ` del elemento ` <scxml> ` en el archivo SCXML:

<scxml
    xmlns="http://www.w3.org/2005/07/scxml"
    version="1.0"
    name="MediaPlayerStateMachine"
    initial="stopped"
    datamodel="cplusplus:TheDataModel:thedatamodel.h"

El formato del atributo ` datamodel ` es: ` cplusplus:<class-name>:<classdef-header>`. Por lo tanto, necesitamos un archivo llamado `thedatamodel.h` que contenga una subclase de ` QScxmlCppDataModel`:

#include "qscxmlcppdatamodel.h"
#include <QtQml/qqml.h>

class TheDataModel: public QScxmlCppDataModel
{
    Q_OBJECT
    Q_SCXML_DATAMODEL

QScxmlCppDataModel deriva de ` QObject`, por lo que añadimos la macro ` Q_OBJECT ` en la sección privada de la definición, justo después del corchete de apertura. A continuación, colocamos la macro ` Q_SCXML_DATAMODEL ` después de ` Q_OBJECT`. La macro se expande en la declaración de métodos virtuales, cuya implementación es generada por el compilador ` Qt SCXML `.

En el archivo SCXML, especificamos las instrucciones de C++ en el elemento <script> y utilizamos el atributo expr para acceder al modelo de datos:

    <state id="stopped">
        <transition event="tap" cond="isValidMedia()" target="playing"/>
    </state>

    <state id="playing">
        <onentry>
            <script>
                media = eventData().value(QStringLiteral(&quot;media&quot;)).toString();
            </script>
            <send event="playbackStarted">
                <param name="media" expr="media"/>
            </send>
        </onentry>

        <onexit>
            <send event="playbackStopped">
                <param name="media" expr="media"/>
            </send>
        </onexit>

        <transition event="tap" cond="!isValidMedia() || media == eventData().value(QStringLiteral(&quot;media&quot;))" target="stopped"/>
        <transition event="tap" cond="isValidMedia() &amp;&amp; media != eventData().value(QStringLiteral(&quot;media&quot;))" target="playing"/>
    </state>

El compilador Qt SCXML genera los distintos métodos evaluateTo y convierte las expresiones y los scripts en lambdas dentro de dichos métodos en mediaplayer.cpp:

bool TheDataModel::evaluateToBool(QScxmlExecutableContent::EvaluatorId id, bool *ok) {
....
    return [this]()->bool{ return isValidMedia(); }();
....
}

QVariant TheDataModel::evaluateToVariant(QScxmlExecutableContent::EvaluatorId id, bool *ok) {
....
        return [this]()->QVariant{ return media; }();
....
}

void TheDataModel::evaluateToVoid(QScxmlExecutableContent::EvaluatorId id, bool *ok) {
....
        [this]()->void{ media = eventData().value(QStringLiteral("media")).toString(); }();
....
}

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.