積木#
VEX IQ(第二代)模組 API 參考文件解釋了每個 VEXcode 模組的功能、其輸入如何改變機器人的行為以及如何在專案中使用該模組。
當您想在將模組新增至專案之前了解模組、檢視模組報告的內容或比較類別中的類似模組時,請使用此參考資料。
VEXcode IQ Blocks 專案使用積木塊。 Python 和 C++ 專案則使用基於文字的 API 部分。
如何解讀區塊條目#
大多數區塊條目包含以下部分:
程式碼區塊描述 - 解釋程式碼區塊的功能以及何時使用。
模組圖像 - 顯示模組在 VEXcode IQ 中的外觀。
參數 - 列出模組的輸入,並解釋每個輸入如何影響機器人或專案。
傳回值 - 說明布林值或報告器區塊報告的內容。
範例 - 展示了在專案中使用該模組的一種方法。
常用區塊類型#
不同形狀的模組在專案中發揮不同的作用。
區塊類型 |
它的意義 |
|---|---|
堆 |
執行特定操作的模組。堆疊模組透過與其他模組的上下連接形成堆疊。 |
帽子 |
當發生某些事情時(例如專案啟動或事件發生時),程式碼區塊會啟動一個程式碼區塊堆疊。 |
布林值 |
傳回True或False的語句區塊。布林語句區塊通常用於條件語句中,例如if then或wait until語句區塊。 |
記者 |
用於報告值(例如數字或文字)的程式碼區塊。報告程式碼區塊通常用於其他程式碼區塊內部。 |
C區 |
一個包裹其他程式碼區塊並控制它們何時或如何運行的程式碼區塊,例如重複程式碼區塊或if then程式碼區塊。 |
範例區塊條目#
用於旋轉馬達#
“旋轉馬達”堆疊模組會使馬達或馬達組旋轉指定的距離。旋轉距離是相對於馬達或馬達組的當前位置而言的。程式會等待馬達或馬達組旋轉完畢後,才會運作堆疊中的下一個模組。
旋轉 [Motor1 v] [前方 v] (90) [度 v] ▶
參數 |
描述 |
|---|---|
引擎 |
要旋轉的馬達或馬達組。請從“設備”視窗中配置的馬達中選擇。 |
方向 |
馬達或馬達組的旋轉方向。預設情況下,選項為正轉和反轉。旋轉方向的選擇可能因馬達配置而異。 |
距離 |
馬達或馬達組的旋轉距離。 度數使用整數。 圈數可以使用整數或小數。 |
單元 |
距離單位:度或圈。 |
不要等待 |
選擇箭頭(▶)展開程式碼區塊,顯示“不要等待”,這樣堆疊中的下一個程式碼區塊就會立即運作。 |
例子
當開始時
[Spin the motor forward once, then reset.]
旋轉 [Motor1 v] [前方 v] (90) [度 v] ▶
旋轉 [Motor1 v] [反向 v] (90) [度 v] ▶