Python

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

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

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

如何阅读方法条目

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

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

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

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

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

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

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

常用 Python API 元素

元素	它的含义
方法	命令调用了一个对象，如 drone.take_off(…)。
函数	直接调用的命令，例如 wait(…) 或 print(…)。
参数	传递给方法或函数的值，用于控制其执行的操作。
可选参数	可以省略的参数，以便使用默认行为。
返回值	命令返回的值，例如数字、文本或布尔值。

Python基础词汇

术语	它的含义
变量	存储值的名称，例如 height = 500。
字符串	引号内的文本，例如 “Hello”。
整数	正数或负数，如 90。
浮点数	一个带有小数的数字，例如 25.5。
布尔值	True 或 False。
实参	传入方法或函数调用的值，例如 drone.take_off(climb_to=500) 中的 500。

示例方法条目

起飞

take_off 启动螺旋桨并将无人机升空。必须先使用此方法，才能进行其他移动。

用法：

drone.take_off(climb_to, units, wait)

参数	描述
climb_to	无人机将飞到的z轴位置。
units	要使用的单位： CM - 厘米 MM - 毫米 INCHES - 英寸
wait	可选。 wait=True（默认）- 无人机等待 take_off 完成后才执行下一行代码。 wait=False - 无人机启动该动作后立即继续执行下一行代码，而不等待 take_off 完成。

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