Eventos

Introducción

Los eventos permiten ejecutar funciones en paralelo. En lugar de llamarlas secuencialmente, puedes registrar varias funciones en un evento y activarlas todas a la vez. Cada función registrada se ejecuta en su propio hilo, lo que permite que tu robot realice varias tareas simultáneamente, como mostrar valores en la pantalla mientras se desplaza.

Para crear y luego usar un evento, siga estos pasos en orden:

1. Crea el evento con Event.

2. Registre una función para activarse cuando se transmita el evento Event llamando al objeto event con la función como argumento.

3. Broadcast an Event:

   • broadcast – Activa todas las funciones registradas en un objeto de evento para que se ejecuten simultáneamente.

   • broadcast_and_wait – Activa todas las funciones registradas en un objeto de evento y espera a que terminen antes de continuar.

Crear un evento

El evento Event crea un objeto de evento que gestiona la ejecución de funciones en hilos separados.

Usage:
Event()

Parámetro	Descripción
	Este constructor no tiene parámetros.

# Blink LEDs while moving forward
# Create move_event as an Event object
move_event = Event()

def blink_leds():
    while True:
        robot.led.on(ALL_LEDS, RED)
        wait(0.5, SECONDS)
        robot.led.on(ALL_LEDS, BLACK)
        wait(0.5, SECONDS)

move_event(blink_leds)
move_event.broadcast()
robot.move_at(0)

Registrar funciones en un evento

Cuando se registra una función en un evento, esta se ejecutará en un hilo independiente cuando se transmita dicho evento.

Usage:
event(callback, args)

Parámetro	Descripción
event	El nombre del objeto de evento creado previamente.
callback	Una función definida previamente que se ejecutará cuando se transmita el evento.
args	Opcional. Una tupla de argumentos para pasar a la función de devolución de llamada.

# Blink LEDs while moving forward and turning
move_event = Event()

def blink_leds():
    while True:
        robot.led.on(ALL_LEDS, RED)
        wait(0.5, SECONDS)
        robot.led.on(ALL_LEDS, BLACK)
        wait(0.5, SECONDS)

def turning():
    robot.turn(RIGHT)

# Register multiple functions to the Event object
move_event(blink_leds)
move_event(turning)

move_event.broadcast()

# Move in a specified direction
move_event = Event()

def move_distance(movement_angle):
    robot.move_for(50, movement_angle)

# Change the parameter to modify how the robot moves
move_event(move_distance, (180,))
move_event.broadcast()

Transmitir un evento

broadcast

broadcast triggers an event, starting all registered functions in separate threads. This method does not pause execution of any subsequent functions.

Usage:
event.broadcast()

Parámetro	Descripción
event	El nombre del objeto de evento creado previamente.

# Blink LEDs while moving forward and turning
move_event = Event()

def blink_leds():
    while True:
        robot.led.on(ALL_LEDS, RED)
        wait(0.5, SECONDS)
        robot.led.on(ALL_LEDS, BLACK)
        wait(0.5, SECONDS)


move_event(blink_leds)

# Trigger the move_event Event
move_event.broadcast()
robot.move_at(0)

broadcast_and_wait

broadcast_and_wait inicia un evento pero espera a que todas las funciones registradas terminen antes de continuar con las funciones subsiguientes.

Usage:
event.broadcast_and_wait()

Parámetro	Descripción
event	El nombre del objeto de evento creado previamente.

# Move after the screen is pressed
move_event = Event()

def move_and_turn():
    robot.move_for(50, 0)
    robot.turn_for(RIGHT, 90)

move_event(move_and_turn)

while True:
    if robot.screen.pressing():
        move_event.broadcast_and_wait()
        break
robot.screen.print("Movement done.")