Python#

VEX IQ（第二代）Python API 參考文件解釋了每個命令、方法和函數的作用、輸入、傳回值以及如何在專案中使用它們。

當您想在將命令新增至項目之前了解該命令、檢查它接受或傳回的值，或比較類別中的相關命令時，請使用此參考。

VEXcode IQ（第二代）Python 專案使用 Python 指令。而 Blocks 和 C++ 專案則使用其他 API 模組。

注意： IQ（第二代）大腦透過記憶體有限的虛擬機器運行 Python 程式。雖然原始程式碼大小有限制，但程式能否運作也取決於其複雜度（例如函數、變數和邏輯的數量）。因此，即使程式大小不超過限制，大型或複雜的程式也可能無法編譯或執行。 C/C++ 程式通常受 IQ（第二代）的這些限制影響較小。

如何閱讀方法條目#

大多數 Python 條目都包含以下部分：

  • 命令名稱 - 命令、方法或函數的正式名稱。

  • 描述 - 解釋該命令的作用以及何時使用該命令。

  • 用法 - 顯示用於在程式碼中編寫命令的語法。

  • 參數 - 列出指令接受的輸入，並解釋每個輸入的作用。

  • 傳回值 - 說明命令傳回的內容（如果有回傳值）。

  • 範例程式碼 - 展示了在專案中使用該命令的一種方法。

常用 Python API 元素#

元素

它的意義

方法

對物件呼叫的命令，例如 drivetrain.drive(…)。

功能

直接呼叫的指令，例如 wait(…) 或 print(…)。

範圍

傳遞給方法或函數的值，用於控制其執行的操作。

可選參數

可以省略的參數，以便使用預設行為。

傳回值

命令傳回的值，例如數字、文字或布林值。

Python基礎詞彙#

學期

它的意義

多變的

儲存值的名稱，例如 speed = 50。

細繩

引號內的文本，例如 “Hello”。

整數

正數或負數，例如 90。

漂浮

帶小數的數字，例如 25.5。

布林值

值為 True （假）或 False假）。

爭論

傳遞給方法或函數呼叫的值，例如 REVERSE in drivetrain.drive(REVERSE, 20, PERCENT)。

範例方法輸入#

駕駛#

drive 使機器人無限前進或後退。機器人將持續移動，直到收到其他指令，例如轉向或停止。

Usage:
drivetrain.drive(direction, velocity, units)

參數

描述

direction

機器人移動方向： FORWARD 或 REVERSE。

velocity

可選。驅動速度，取值範圍為 0% 到 100%（使用 PERCENT時）、0 到 120 rpm（使用 RPM時）或 0 到 720 度/秒（使用 VelocityUnits.DPS時）。該值可以是整數 integer 或十進制數（float）。如果未提供速度，機器人將以目前驅動速度行駛。

units

可選。速度單位： PERCENT （預設）， RPM （每分鐘轉數），或 VelocityUnits.DPS （每秒度數）。

 
# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()


# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()
On this page