Python#

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

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

VEXcode V5 Python 项目使用 Python 命令。而 Blocks 和 C++ 项目则使用其他 API 模块。

如何阅读方法条目#

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

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

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

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

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

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

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

常用 Python API 元素#

元素

它的含义

方法

对对象调用的命令，例如 drivetrain.drive(…)。

功能

直接调用的命令，例如 wait(…) 或 print(…)。

范围

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

可选参数

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

返回值

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

Python基础词汇#

学期

它的含义

多变的

存储值的名称，例如 speed = 50。

细绳

引号内的文本，例如 “Hello”。

整数

正数或负数，例如 90。

漂浮

带小数的数字，例如 25.5。

布尔值

值为 True （假）或 False。

争论

传递给方法或函数调用的值，例如 360.0 in drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)。

示例方法输入#

驾驶#

drive 使机器人无限前进或后退。机器人将持续运动，直到收到其他指令，例如转向或停止。转速（RPM）或每秒角度数的限制取决于传动系统的齿轮比。

Usage:
drivetrain.drive(direction, velocity, units)

参数

描述

direction

机器人移动方向： FORWARD 或 REVERSE。

velocity

可选。驱动速度，取值范围为 0% 到 100%（使用 PERCENT时）、0 到 600 rpm（使用 RPM时）或 0 到 3600 度/秒（使用 VelocityUnits.DPS时）。该值可以是整数 integerfloat）。如果未提供速度，机器人将以当前驱动速度行驶。

units

可选。速度单位： RPM （每分钟转数，默认值）， PERCENT，或 VelocityUnits.DPS （每秒度数）。

 
# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()


# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)
On this page