Qt SCXML Media Player Example (Dynamic)

A widget-based application that sends data to and receives it from a dynamically loaded ECMAScript data model.

Article lu fois.

L'auteur

The Qt Company Ltd.

L'article

Publié le 26 janvier 2024 - Mis à jour le 26 janvier 2024

Liens sociaux

Qt SCXML Media Player Example (Dynamic)▲

Media Player Example (Dynamic) demonstrates how to access data from a dynamically loaded ECMAScript data model.

The UI is created using Qt Widgets.

Running the Example▲

To run the example from Qt Creator, open the Welcome mode and select the example from Examples. For more information, visit Building and Running an Example.

Using the ECMAScript Data Model▲

We specify the data model as a value of the datamodel attribute of the <scxml> element in mediaplayer-common/mediaplayer.scxml:

Sélectionnez

&lt;scxml
    xmlns="http://www.w3.org/2005/07/scxml"
    version="1.0"
    name="MediaPlayerStateMachine"
    initial="stopped"
    datamodel="ecmascript"
&gt;
    &lt;datamodel&gt;
        &lt;data id="media"/&gt;
    &lt;/datamodel&gt;

Dynamically Loading the State Machine▲

We link against the Qt SCXML module by adding the following line to the project build files.

With qmake to the mediaplayer-widgets-dynamic.pro

Sélectionnez

QT += widgets scxml

With cmake to the CMakeLists.txt

Sélectionnez

find_package(Qt6 REQUIRED COMPONENTS Core Gui Scxml Widgets)

target_link_libraries(mediaplayer-widgets-dynamic PUBLIC
    Qt6::Core
    Qt6::Gui
    Qt6::Scxml
    Qt6::Widgets
)

We dynamically create and instantiate the state machine in mediaplayer-wigdets-dynamic/mediaplayer-widgets-dynamic.cpp:

Sélectionnez

#include "../mediaplayer-common/mainwindow.h"

#include &lt;QApplication&gt;
#include &lt;QScxmlStateMachine&gt;

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    auto machine = QScxmlStateMachine::fromFile(
                QStringLiteral(":mediaplayer.scxml"));
    MainWindow mainWindow(machine);
    machine-&gt;setParent(&amp;mainWindow);

    machine-&gt;start();
    mainWindow.show();
    return app.exec();
}

Connecting to States▲

The media player state machine will send out events when users tap a control and when playback starts or stops, as specified in the SCXML file:

Sélectionnez

    &lt;state id="stopped"&gt;
        &lt;transition event="tap" cond="isValidMedia()" target="playing"/&gt;
    &lt;/state&gt;

    &lt;state id="playing"&gt;
        &lt;onentry&gt;
            &lt;assign location="media" expr="_event.data.media"/&gt;
            &lt;send event="playbackStarted"&gt;
                &lt;param name="media" expr="media"/&gt;
            &lt;/send&gt;
        &lt;/onentry&gt;

        &lt;onexit&gt;
            &lt;send event="playbackStopped"&gt;
                &lt;param name="media" expr="media"/&gt;
            &lt;/send&gt;
        &lt;/onexit&gt;

        &lt;transition event="tap" cond="!isValidMedia() || media === _event.data.media" target="stopped"/&gt;
        &lt;transition event="tap" cond="isValidMedia() &amp;amp;&amp;amp; media !== _event.data.media" target="playing"/&gt;
    &lt;/state&gt;

To be notified when a state machine sends out an event, we connect to the corresponding signals:

Sélectionnez

    stateMachine-&gt;connectToEvent("playbackStarted", this, &amp;MainWindow::started);
    stateMachine-&gt;connectToEvent("playbackStopped", this, &amp;MainWindow::stopped);

Example project▲

Example project @ code.qt.io

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants :