Python

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

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

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

如何阅读方法条目

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

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

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

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

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

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

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

常用 Python API 元素

元素	它的含义
方法	A command called on an object such as arm.move_inc(…).
功能	A command called directly, such as wait(…) or print(…).
范围	传递给方法或函数的值，用于控制其执行的操作。
可选参数	可以省略的参数，以便使用默认行为。
返回值	命令返回的值，例如数字、文本或布尔值。

Python基础词汇

学期	它的含义
多变的	A name that stores a value, such as x_target = 120.
细绳	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 100 in arm.move_inc(0, 100, 0).

示例方法输入

move_inc

move_inc moves the 6-Axis Arm by a specified distance along the x, y, and z axes.

此方法将返回一个布尔值，指示六轴机械臂是否已到达请求的位置：

• True - The 6-Axis Arm has reached the requested position.

• False - The 6-Axis Arm cannot reach the requested position.

Usage:
arm.move_inc(x, y, z, wait)

范围	描述
x	沿 x 轴移动的距离（单位：毫米）。
是	沿 y 轴移动的距离（单位：毫米）。
z	沿 z 轴移动的距离，单位为毫米。
wait	Optional. wait=True (default) - The project waits until move_inc is complete before executing the next line of code. wait=False - The project starts the action and moves on to the next line of code right away, without waiting for move_inc to finish.

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)