Eventos

Introdução

Os eventos permitem executar funções em paralelo. Em vez de chamar funções sequencialmente, pode registar várias funções num evento e acioná-las simultaneamente. Cada função registada é executada no seu próprio thread, permitindo que o seu robô realize várias tarefas ao mesmo tempo — como exibir valores no ecrã enquanto se move.

Para criar e utilizar um evento, siga os seguintes passos pela ordem indicada:

1. Crie o evento com Event.

2. Register a function to trigger when the Event is broadcast by calling the event object with the function as an argument.

3. Broadcast an Event:

   • broadcast – Aciona todas as funções registadas num objeto de evento para serem executadas em simultâneo.

   • broadcast_and_wait – Aciona todas as funções registadas num objeto de evento e espera que terminem antes de continuar.

Criar um evento

Event cria um objeto de evento que gere a execução de funções em threads separados.

Usage:
Event()

Parâmetros	Descrição
	Este construtor não possui parâmetros.

def move_square():
    for index in range(4):
        robot.drive_for(FORWARD, 1, STEPS)
        robot.turn_for(RIGHT, 90)

# Creating the move_event Event
move_event = Event()
move_event(move_square)
move_event.broadcast()
robot.led.glow(GREEN)

Registar funções num evento

Ao registar uma função para um evento, esta será executada num thread separado quando o evento for transmitido.

Usage:
event(callback, args)

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.
callback	Uma função previamente definida para ser executada quando o evento é transmitido.
args	Opcional. Uma tupla de argumentos para passar para a função de callback.

def move_square():
    for index in range(4):
        robot.drive_for(FORWARD, 1, STEPS)
        robot.turn_for(RIGHT, 90)

move_event = Event()
# Register the move_square function to the move_event Event
move_event(move_square)
move_event.broadcast()
robot.led.glow(GREEN)

Transmita um evento

broadcast

O comando broadcast dispara um evento, iniciando todas as funções registadas em threads separados. Este método não interrompe a execução de qualquer código subsequente.

Usage:
event.broadcast()

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.

def move_square():
    for index in range(4):
        robot.drive_for(FORWARD, 1, STEPS)
        robot.turn_for(RIGHT, 90)

move_event = Event()
move_event(move_square)
# Broadcasting the move_event Event
move_event.broadcast()
robot.led.glow(GREEN)

broadcast_and_wait

broadcast_and_wait inicia um evento, mas espera que todas as funções registadas terminem antes de continuar com as funções subsequentes.

Usage:
event.broadcast_and_wait()

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.

def move_square():
    for index in range(4):
        robot.drive_for(FORWARD, 1, STEPS)
        robot.turn_for(RIGHT, 90)

# Set up and call the move_square event
move_event = Event()
move_event(move_square)
# Broadcast the move_event Event and wait
move_event.broadcast_and_wait()
robot.led.glow(GREEN)