区块#

VEX IQ（第二代）模块 API 参考文档解释了每个 VEXcode 模块的功能、其输入如何改变机器人的行为以及如何在项目中使用该模块。

当您想在将模块添加到项目之前了解该模块、查看模块报告的内容或比较类别中的类似模块时，请使用此参考资料。

VEXcode IQ Blocks 项目使用积木块。Python 和 C++ 项目则使用基于文本的 API 部分。

如何解读块条目#

大多数区块条目包含以下部分：

  • 代码块描述 - 解释代码块的功能以及何时使用。

  • 模块图像 - 显示模块在 VEXcode IQ 中的外观。

  • 参数 - 列出模块的输入，并解释每个输入如何影响机器人或项目。

  • 返回值 - 说明布尔值或报告器块报告的内容。

  • 示例 - 展示了在项目中使用该模块的一种方法。

常用块类型#

不同形状的模块在项目中发挥着不同的作用。

块类型

它的含义

堆

执行特定操作的模块。堆叠模块通过与其他模块的上下连接形成堆叠。

帽子

当发生某些事情时（例如项目启动或事件发生时），该代码块会启动一个代码块堆栈。

布尔值

返回True或False的语句块。布尔语句块通常用于条件语句中，例如if then或wait until语句块。

记者

用于报告值（例如数字或文本）的代码块。报告代码块通常用于其他代码块内部。

C区

一个包裹其他代码块并控制它们何时或如何运行的代码块，例如重复代码块或if then代码块。

示例块条目#

用于旋转马达#

“旋转电机”堆栈模块会使电机或电机组旋转指定的距离。旋转距离是相对于电机或电机组的当前位置而言的。程序会等待电机或电机组旋转完毕后，才会运行堆栈中的下一个模块。

spin [Motor1 v] [forward v] for (90) [degrees v] ▶

参数

描述

发动机

要旋转的电机或电机组。请从“设备”窗口中配置的电机中选择。

方向

电机或电机组的旋转方向。默认情况下，选项为正转和反转。旋转方向的选择可能因电机配置而异。

距离

电机或电机组的旋转距离。度数使用整数。圈数可以使用整数或小数。

单元

距离单位：度或圈。

不要等待

选择箭头（▶）展开代码块，显示“不要等待”，这样堆栈中的下一个代码块就会立即运行。

例子

when started
[Spin the motor forward once, then reset.]
spin [Motor1 v] [forward v] for (90) [degrees v] ▶
spin [Motor1 v] [reverse v] for (90) [degrees v] ▶
On this page