控制#

简介#

Control in Python lets you tell the robot when to wait, when to repeat actions, how to make decisions, and when to end the project.

以下是所有控制指令的清单，包括方法和核心 Python 关键字：

  • wait – Pauses the project for a given time.

  • [for] (#for) –对序列中的每个项目重复代码。

  • if – Runs code if a condition is true.

  • [if/else] (#ifelse) –根据条件运行不同的代码。

  • [if/elif/else] (#ifelifelse) –按顺序检查多个条件。

  • [while] (#while) –条件为true时重复代码。

  • [break] (#break) –立即退出循环。

  • [stop_program] (#stop-program) –结束正在运行的程序。

  • [pass] (#pass) –无需执行任何操作时使用占位符。

Wait#

wait 暂停一段特定的时间，然后转到下一行代码。

Usage:
wait(time, units)

参数

描述

time

The amount of time to wait, as a positive whole number or decimal.

units

The unit that represents the wait time: MSEC (default) – milliseconds, or SECONDS

 
# Move right for one second, then stop
robot.move_at(90)
wait(1, SECONDS)
robot.stop_all_movement()

For#

for repeats a set of actions a specific number of times. for can be used to loop through items in lists, tuples, dictionaries, sets, strings, or for a specified amount of loops with range.

Usage:

for value in expression_list:
    pass

Components

描述

value

存储迭代中的当前元素的临时变量。

expression_list

循环遍历的元素集合（例如，列表、字符串、范围）。

 
# Move in a square path.
for index in range(4):
    robot.move_for(50, 0)
    robot.turn_for(RIGHT, 90)


# Print each item in the list
colors = ["Red", "Green", "Blue"]

for color in colors:
    robot.screen.print(color)
    robot.screen.next_row()

显示正在屏幕上打印的三个对象。

If#

if runs the indented block of code if the condition is True.

用法：

if condition:
    pass

Components

描述

condition

An expression or variable that is checked when the statement runs. If it is True, the code inside the if block executes; if it is False, the block is skipped.

 
# Kick when the screen is pressed
while True:
    if robot.screen.pressing():
        robot.kicker.kick(MEDIUM)
    wait(0.1, SECONDS)

If/Else#

if and else determine which indented block of code runs based on whether the condition is True or False.

用法：

if condition:
    pass
else:
    pass

Components

描述

condition

An expression or variable that is checked when the statement runs. If it is True, the code inside the if block executes; if it is False, the code inside the else block executes instead.

 
# Show one emoji when the screen is pressed,
# and a different emoji when not pressed
while True:
    if robot.screen.pressing():
        robot.screen.show_emoji(EXCITED)

    else:
        robot.screen.show_emoji(BORED)
    
    wait(0.1, SECONDS)

If/Elif/Else#

if/elif/else 结构根据条件选择哪个缩进代码块运行：

  • if runs its block if the condition is True.

  • elif checks additional conditions only if all previous conditions are False. Multiple elif statements can be used.

  • else runs its block only if none of the previous conditions are True.

用法：

if condition:
    pass
elif condition:
    pass
else:
    pass

Components

描述

condition

An expression or variable that is checked when the statement runs. The first condition that is True determines which block executes; if none are True, the else block runs.

 
# Move the robot forward or reverse
# based on the position of the joystick
def when_axis_changed():
    position = controller.axis1.position()
    if position > 0:
        robot.move_at(0)
    elif position < 0:
        robot.move_at(180)
    else:
        robot.stop_all_movement()

controller.axis1.changed(when_axis_changed)

While#

while repeatedly runs code as long as the condition is True. It can also be used like a “forever” by using True as the condition, or a “wait until” by adding not to the condition, as shown in the examples below.

用法：

while condition:
    pass

Components

描述

condition

An expression or variable that is checked before each iteration. If it is True, the loop continues; if it is False, the loop stops.

 
# Keep the LEDs green while the robot is moving
robot.move_for(200, 0, wait=False)
while robot.is_move_active():
    robot.led.on(ALL_LEDS, GREEN)
    wait(50, MSEC)

robot.led.on(ALL_LEDS, BLACK)


while True:
    # Continually flash all LEDs red then green.
    robot.led.on(ALL_LEDS, RED)
    wait(0.5, SECONDS)
    robot.led.on(ALL_LEDS, GREEN)
    wait(0.5, SECONDS)


# Wait until the screen is pressed before
# turning off the LEDs
while not robot.screen.pressing():
    robot.led.on(ALL_LEDS, RED)
    wait(50, MSEC)

robot.led.on(ALL_LEDS, BLACK)

Break#

break exits a loop immediately. break can be used to leave loops that otherwise would loop forever.

# Flash LEDs until the screen is pressed
while True:
    robot.led.on(ALL_LEDS, RED)
    wait(0.5, SECONDS)
    robot.led.on(ALL_LEDS, GREEN)
    wait(0.5, SECONDS)

    if robot.screen.pressing():
        break

# Turn the LEDs Off
robot.led.off(ALL_LEDS)

Stop Program#

stop_program ends a running project.

Usage:
robot.stop_program()

参数

描述

该方法没有参数。

 
# Stop the project once the screen is pressed
while True:
    robot.led.on(ALL_LEDS, RED)
    wait(0.5, SECONDS)
    robot.led.on(ALL_LEDS, GREEN)
    wait(0.5, SECONDS)
    if robot.screen.pressing():
        robot.stop_program()

Pass#

pass 是未来代码的占位符，可用于避免空循环、条件和函数中的错误。

if condition:
    pass


def function():
    pass
On this page