Python#

VEX AIR Python API 参考文档解释了每个命令、方法和函数的作用、使用的输入、返回值以及如何在项目中使用它们。

当您想在将命令添加到项目之前了解该命令、检查它接受或返回的值，或者比较类别中的相关命令时，请使用此参考。

VEXcode AIR Python 项目使用 Python 命令。而 Blocks 项目则使用 Blocks API 部分。

如何阅读方法条目#

大多数 Python 条目都包含以下部分：

  • 命令名称 - 命令、方法或函数的正式名称。

  • 描述 - 解释该命令的作用以及何时使用该命令。

  • 用法 - 显示用于在代码中编写命令的语法。

  • 参数 - 列出命令接受的输入，并解释每个输入的作用。

  • 返回值 - 说明命令返回的内容（如果有返回值）。

  • 示例代码 - 展示了在项目中使用该命令的一种方法。

常用 Python API 元素#

元素

它的含义

方法

A command called on an object such as drone.take_off(…).

功能

A command called directly, such as wait(…) or print(…).

范围

传递给方法或函数的值，用于控制其执行的操作。

可选参数

可以省略的参数，以便使用默认行为。

返回值

命令返回的值，例如数字、文本或布尔值。

Python基础词汇#

学期

它的含义

多变的

A name that stores a value, such as height = 500.

细绳

Text inside quotes, such as “Hello”.

整数

A positive or negative number, such as 90.

漂浮

A number with a decimal, such as 25.5.

布尔值

A value that is either True or False.

争论

A value passed into a method or function call, such as 500 in drone.take_off(climb_to=500).

示例方法条目#

起飞#

take_off starts the propellers and lifts the drone into the air. This method must be used before other movements can be made.

用法：

drone.take_off(climb_to, units, wait)

参数

描述

climb_to

无人机将飞到的z轴位置。

units

The unit to use:

  • CM - Centimeters
  • MM - Millimeters
  • INCHES

wait

Optional.

  • wait=True (default) - The drone waits until take_off is complete before executing the next line of code.
  • wait=False - The drone starts the action and moves on to the next line of code right away, without waiting for take_off to finish.

 
# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()
On this page