Python

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

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

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

如何阅读方法条目

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

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

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

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

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

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

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

常用 Python API 元素

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

Python基础词汇

术语	它的含义
变量	存储值的名称，例如 speed = 50。
String	引号内的文本，例如 “Hello”。
整数	正数或负数，如 90。
** 浮点数**	一个带有小数的数字，例如 25.5。
布尔值	True 或 False。
Argument	传递给方法或函数调用的值，例如 0 中的 robot.move_at(0)。

示例方法条目

move_at

move_at 使机器人以特定角度持续移动。机器人会一直移动，直到收到其他动作指令，例如以不同角度移动、转向或停止。

用法：
robot.move_at(angle, velocity, units)

参数	描述
angle	机器人移动的角度，以度为单位。该值可以是介于 -360 到 360 之间的整数或小数。
velocity	可选。移动速度：使用 PERCENT 时为 0% 到 100%，使用 MMPS 时为 0 到 200 毫米/秒。可以是整数或小数。如果未提供速度，机器人将以当前移动速度移动。
units	可选。速度单位：PERCENT（默认）或 MMPS（毫米/秒）。

# Move forward
robot.move_at(0)