区块#

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

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

VEXcode VR 中的模块可能取决于您使用的 Playground 和机器人。某些机器人包含独特的模块,这些模块并非在每个 Playground 中都会出现。

VR中的游乐场和机器人#

使用 Playgrounds 部分查看每个 Playground 中使用的机器人,并查找 Playground 特定的设置详情、场地信息和挑战背景。

使用 机器人 部分查找具有独特功能的机器人的专属模块页面。机器人页面还会显示每个机器人所使用的 Playground,以便您了解项目中何时可以使用机器人专属模块。

如何解读块条目#

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

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

  • 方块图像 - 显示方块在 VEXcode VR 中的外观。

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

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

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

常用块类型#

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

块类型

它的含义

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

帽子

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

布尔值

返回TrueFalse的语句块。布尔语句块通常用于条件语句中,例如if thenwait until语句块。

记者

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

C区

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

块条目示例#

驾驶#

驱动 模块使机器人能够无限向前或向后移动。机器人将持续移动,直到收到其他指令,例如转向或停止。

驱动 [向前 v]

参数

描述

方向

机器人移动方向:前进后退

例子

当开始 :: hat events
[Drive forward, then stop.]
驱动 [向前 v]
等待 (2) 秒
驱动停止