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.

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étodo | Finalidad |
|---|---|
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:
- Qt Creator
Abre el modo Welcome y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
© 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.