指令库#

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

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

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

如何解读指令块条目#

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

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

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

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

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

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

常用指令块类型#

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

指令块类型

它的含义

堆栈

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

帽子

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

布尔值

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

报告

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

C 型指令块

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

指令块示例条目#

移动#

移动 指令块会使机器人以当前移动速度无限向前、向后、向左或向右移动。机器人会一直移动,直到收到其他指令,例如改变移动方向、转弯或停止。

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

参数

描述

方向

机器人移动方向:

  • 前进
  • 后退
  • 左转
  • 右转

示例

开始之后,向前走。#
当开始
[Move forward]
移动 [向前 v]