En esta página

TaskTree: semáforo

Muestra cómo implementar el comportamiento de una máquina de estados utilizando TaskTree mediante una simulación de un semáforo.

El semáforo de TaskTree es una implementación alternativa a los ejemplos de semáforos que aparecen en Qt SCXML y Qt State Machine.

Semáforo con la luz verde encendida y un botón de pausa

La aplicación consta de tres componentes principales:

  • Un widget « TrafficLight » que muestra el estado actual.
  • Una receta de « TaskTree » que controla las transiciones de estado.
  • Un « GlueInterface » que sincroniza la interfaz de usuario con la máquina de estados.

En las siguientes secciones se describen con más detalle los códigos del ejemplo.

Clase auxiliar de enlace

La clase ` GlueInterface ` proporciona una separación clara entre la interfaz de usuario y la lógica operativa.

enum class Light
{
    Off    = 0,
    Red    = 1 << 0,
    Yellow = 1 << 1,
    Green  = 1 << 2,
};

Q_DECLARE_FLAGS(Lights, Light)
Q_DECLARE_OPERATORS_FOR_FLAGS(Lights)

class GlueInterface final : public QObject
{
    Q_OBJECT

public:
    // operational logic -> GUI
    void setLights(Lights lights) { emit lightsChanged(lights); }

    // GUI -> operational logic
    void smash() { emit smashed(); }
    void repair() { emit repaired(); }

signals:
    void lightsChanged(Lights lights);

    void smashed();
    void repaired();
};

La clase « GlueInterface » proporciona los siguientes métodos de interfaz:

MétodoFinalidad
setLights()Actualiza el estado del semáforo a partir de la receta de TaskTree
lightsChanged()Notifica a la interfaz de usuario cuando cambia el estado de los semáforos
smash()/ repair()Gestiona la simulación de fallos y las acciones de recuperación

Cuando los usuarios interactúan con la interfaz de usuario:

  • Al hacer clic en «Pausa» se activa « smash() », lo que simula un fallo.
  • Al hacer clic en «Reproducir», se activa repair(), lo que restablece el funcionamiento normal.

Implementación de la máquina de estados

La lógica de la máquina de estados se implementa mediante una receta de TaskTree. El método ` recipe() ` crea esta lógica utilizando una referencia a ` GlueInterface`:

ExecutableItem recipe(GlueInterface &iface)
{
    return Forever {
        Group { // "working" state
            stopOnSuccess,
            parallel,
            signalAwaiterTask(&iface, &GlueInterface::smashed), // transitions to the "broken" state
            Forever {
                switchLightsTask(&iface, Light::Red, 3s), // "red" state
                switchLightsTask(&iface, Light::Red | Light::Yellow, 1s), // "redGoingGreen" state
                switchLightsTask(&iface, Light::Green, 3s), // "green" state
                switchLightsTask(&iface, Light::Yellow, 1s), // "greenGoingRed" state
            }
        },
        Group { // "broken" state
            stopOnSuccess,
            parallel,
            signalAwaiterTask(&iface, &GlueInterface::repaired), // transitions to the "working" state
            Forever {
                switchLightsTask(&iface, Light::Yellow, 1s), // "blinking" state
                switchLightsTask(&iface, Light::Off, 1s), // "unblinking" state
            }
        }
    };
}
Gestión del estado raíz

El elemento de nivel superior « Forever » ejecuta a sus elementos secundarios en un bucle infinito. Contiene dos subgrupos que representan los estados «en funcionamiento » y «averiado ».

Reglas de transición de estados:

  • Los estados se ejecutan en secuencia, ya que el valor predeterminado de ` execution mode ` es ` sequential`.
  • Cuando se completa un estado, comienza el siguiente.
  • Las transiciones se activan cuando un usuario hace clic en el botón de pausa o reproducción de la interfaz de usuario, lo que emite la señal correspondiente.
El estado de funcionamiento «working»

El estado de funcionamiento « Group » consta de dos tareas que se ejecutan en « parallel »:

  • signalAwaiterTask se conecta a la señal GlueInterface::smashed. Si se activa la señal, la tarea finaliza inmediatamente con DoneResult::Success. Esto hace que Group deje de ejecutarse y que la receta pase al estado «rot ».
  • La tarea anidada « Forever » consta de cuatro tareas « switchLightsTask » («red», «redGoingGreen», «green» y «greenGoingRed») que se ejecutan sequentially en un bucle infinito.

El elemento « stopOnSuccess » de cada grupo le indica que deje de ejecutarse cuando cualquiera de sus tareas secundarias finalice con « DoneResult::Success ».

La implementación de « switchLightsTask »:

  • Actualiza los estados de las luces mediante « GlueInterface::setLights() ».
  • Crea un retraso temporizado mediante « timeoutTask ».
  • Mantiene el estado durante el tiempo especificado mediante « timeout ».
static Group switchLightsTask(GlueInterface *iface, Lights lights, const milliseconds &timeout)
{
    return {
        onGroupSetup([iface, lights] { iface->setLights(lights); }),
        timeoutTask(timeout, DoneResult::Success)
    };
}
El estado de funcionamiento «defectuoso»

El « Group » en estado de avería es similar al « Group » en funcionamiento. La única diferencia es que se conecta a la señal « GlueInterface::repaired », y las luces alternan únicamente entre dos estados, encendiendo y apagando la luz amarilla.

Configuración de la aplicación

La configuración principal de la aplicación crea y conecta todos los componentes:

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

    GlueInterface iface;
    QTaskTree taskTree({recipe(iface)});
    TrafficLight widget(iface);

    widget.show();
    taskTree.start();

    return app.exec();
}

La función ` main() ` instancia los objetos `QApplication`, ` GlueInterface`, `QTaskTree` y ` TrafficLight `.

Para construir el objeto ` taskTree `, pasamos un ` recipe() ` construido con el objeto ` iface `. El ` widget ` también utiliza el objeto ` iface ` que se le ha pasado.

Antes de ejecutar la aplicación, la función ` main() ` muestra el widget ` TrafficLight ` e inicia el árbol de tareas.

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

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.