Події#

Вступ#

Події дозволяють запускати функції паралельно. Замість послідовного виклику функцій, ви можете зареєструвати кілька функцій для події та запускати їх усі одночасно. Кожна зареєстрована функція виконується у власному потоці, що дозволяє вашому роботу виконувати кілька завдань одночасно, наприклад, відображати значення на екрані під час руху.

Щоб створити та використовувати подію, виконайте такі дії в такому порядку:

  1. Створіть подію за допомогою Event.

  2. Зареєструйте функцію, яка спрацьовуватиме при трансляції події Event , викликавши event об’єкт з функцією як аргументом.

  3. Broadcast an Event:

    • broadcast – Запускає всі зареєстровані функції в об’єкті події для одночасного виконання.

    • broadcast_and_wait – Запускає всі зареєстровані функції в об’єкті події та очікує їх завершення, перш ніж продовжити.

Створити подію#

Event створює об’єкт події, який керує виконанням функцій в окремих потоках.

Usage:
Event()

Параметр

Опис

Цей конструктор не має параметрів.

# 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)

Реєстрація функцій для події#

Коли ви реєструєте функцію для події, вона виконуватиметься в окремому потоці під час трансляції події.

Usage:
event(callback, args)

Параметр

Опис

event

Ім’я раніше створеного об’єкта події.

callback

Попередньо визначена функція, яка виконується під час трансляції події.

args

Необов’язково. Кортеж tuple аргументів для передачі функції зворотного виклику.

# 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()

Трансляція події#

broadcast#

broadcast запускає подію, запускаючи всі зареєстровані функції в окремих потоках. Цей метод не призупиняє виконання жодних наступних функцій.

Usage:
event.broadcast()

Параметр

Опис

event

Ім’я раніше створеного об’єкта події.

# 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 запускає подію, але очікує завершення всіх зареєстрованих функцій, перш ніж продовжити виконання наступних функцій.

Usage:
event.broadcast_and_wait()

Параметр

Опис

event

Ім’я раніше створеного об’єкта події.

# 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.")