指令块#

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

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

VEXcode AIR Blocks 项目使用指令块。Python 项目则使用基于文本的 API 部分。

如何解读指令块条目#

大多数指令块条目包含以下部分:

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

  • 指令块图像 - 显示指令块在 VEXcode AIR 中的外观。

  • 参数 - 列出指令块上的输入,并解释每个输入如何影响无人机或项目。

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

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

常用指令块类型#

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

指令块类型

它的含义

堆栈

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

帽子

当发生某些事情时(例如项目启动或事件发生时),该代码块会启动一个指令块堆栈。

布尔值

返回真或假的语句块。布尔语句块通常用于条件语句中,例如如果那么或等到指令块。

报告

用于报告值(例如数字或文本)的指令块。报告指令块通常用于其他指令块内部。

C 型

一个包裹其他指令块并控制它们何时或如何运行的代码块,例如重复代码块或如果那么指令块。

指令块示例条目#

移动#

移动指令块使用当前的移动速度使无人机沿四个特定方向移动。

向前移动指令块#
移动 [向前 v]

参数

描述

方向

让无人机朝以下方向之一移动:

  • 前进
  • 右
  • 左
  • 后退

示例

当开始
[Move forward for 2 seconds.]
起飞至 [500] [毫米 v] ▶
移动 [向前 v]
等待 [2] 秒
土地 ▶