積木#

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] 度 ▶