区块#

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

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

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

如何解读块条目#

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

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

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

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

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

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

常用块类型#

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

块类型

它的含义

堆

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

帽子

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

布尔值

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

记者

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

C区

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

块条目示例#

转向#

“转向”堆栈模块会使机器人向左或向右旋转指定的角度。旋转角度是相对于机器人的当前位置而言的。程序会等待机器人完成旋转后，才会运行堆栈中的下一个模块。

[右 v] 转 [90] 度 ▶

参数

描述

方向

机器人转向的方向：向左或向右。

角度

机器人旋转的角度数。可以是整数，也可以是小数。

不要等待

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

例子

当开始
[Turn left, then turn around to the right.]
[左 v] 转 [90] 度 ▶
[右 v] 转 [180] 度 ▶
On this page