SCXML Traffic Light (Dynamic, QML)

A Qt Quick application that uses a dynamically loaded state machine to implement a traffic light.

Article lu fois.

L'auteur

The Qt Company Ltd.

L'article

Publié le 27 décembre 2024 - Mis à jour le 27 décembre 2024

Liens sociaux

SCXML Traffic Light (Dynamic, QML)▲

Traffic Light QML demonstrates how to connect to the active properties of a state in a dynamically loaded state machine.

The UI is created using Qt Quick.

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.

Dynamically Loading the State Machine▲

We link against the Qt SCXML module by adding the following lines to the example's build files.

To .pro when using qmake:

Sélectionnez

QT += qml scxml

To CMakeLists.txt when using cmake:

Sélectionnez

find_package(Qt6 REQUIRED COMPONENTS Core Gui Qml Scxml)
target_link_libraries(trafficlight-qml-dynamic PRIVATE
    Qt6::Core
    Qt6::Gui
    Qt6::Qml
    Qt6::Scxml
)

We dynamically create the state machine in the main QML file:

Sélectionnez

import QtScxml
import TrafficLightApplication

Window {
    width: lights.width
    height: lights.height
    visible: true

    Lights {
        id: lights
        stateMachine: loader.stateMachine
        // Suppress qmllint warning, dynamic statemachine properties not known at compile-time
        // qmllint disable missing-property
        button.source: stateMachine.working ? "pause.png" : "play.png"
        button.onClicked: stateMachine.submitEvent(stateMachine.working ? "smash" : "repair");
        // qmllint enable missing-property
    }

    StateMachineLoader {
        id: loader
        source: Qt.resolvedUrl("statemachine.scxml")
    }
}

Connecting to States▲

In the SCXML file, we specify states for each light: red, yellow, and green. In the <onentry> element, we specify the event to send when entering the state and the delay in seconds before sending the event. In the <transition> element, we specify the event that triggers the transition to the state specified by the target attribute:

Sélectionnez

        &lt;state id="red"&gt;
            &lt;onentry&gt;
                &lt;send event="startGoingGreen" delay="3s"/&gt;
            &lt;/onentry&gt;
            &lt;transition event="startGoingGreen" target="redGoingGreen"/&gt;
        &lt;/state&gt;

        &lt;state id="yellow" initial="greenGoingRed"&gt;
            &lt;state id="redGoingGreen"&gt;
                &lt;onentry&gt;
                    &lt;send event="goGreen" delay="1s"/&gt;
                &lt;/onentry&gt;
                &lt;transition event="goGreen" target="green"/&gt;
            &lt;/state&gt;

            &lt;state id="greenGoingRed"&gt;
                &lt;onentry&gt;
                    &lt;send event="goRed" delay="1s"/&gt;
                &lt;/onentry&gt;
                &lt;transition event="goRed" target="red"/&gt;
            &lt;/state&gt;
        &lt;/state&gt;

        &lt;state id="green"&gt;
            &lt;onentry&gt;
                &lt;send event="startGoingRed" delay="3s"/&gt;
            &lt;/onentry&gt;
            &lt;transition event="startGoingRed" target="greenGoingRed"/&gt;
        &lt;/state&gt;

We connect to the states as follows:

Sélectionnez

    states: [
        // Suppress qmllint warning, dynamic statemachine properties not known at compile-time
        // qmllint disable missing-property
        State {
            name: "Red"
            when: lights.stateMachine.red

            PropertyChanges { redLight.opacity: 1 }
        },
        State {
            name: "RedGoingGreen"
            when: lights.stateMachine.redGoingGreen

            PropertyChanges { redLight.opacity: 1 }
            PropertyChanges { yellowLight.opacity: 1 }
        },
        State {
            name: "Yellow"
            when: lights.stateMachine.yellow || lights.stateMachine.blinking

            PropertyChanges { yellowLight.opacity: 1 }
        },
        State {
            name: "Green"
            when: lights.stateMachine.green

            PropertyChanges { greenLight.opacity: 1 }
        }
        // qmllint enable missing-property
    ]

Example project▲

Example project @ code.qt.io

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