Python

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

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

VEXcode AIR Python 專案使用 Python 指令。而 Blocks 專案則使用 Blocks API 部分。

如何閱讀方法條目

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

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

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

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

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

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

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

常用 Python API 元素

元素	它的意義
方法	對物件呼叫的命令，例如 drone.take_off(…)。
功能	直接呼叫的指令，例如 wait(…) 或 print(…)。
範圍	傳遞給方法或函數的值，用於控制其執行的操作。
可選參數	可以省略的參數，以便使用預設行為。
傳回值	命令傳回的值，例如數字、文字或布林值。

Python基礎詞彙

學期	它的意義
多變的	儲存值的名稱，例如 height = 500。
細繩	引號內的文本，例如 “Hello”。
整數	正數或負數，例如 90。
漂浮	帶小數的數字，例如 25.5。
布林值	值為 True （假）或 False假）。
爭論	傳遞給方法或函數呼叫的值，例如 500 in drone.take_off(climb_to=500)。

範例方法條目

起飛

take_off 啟動螺旋槳，將無人機升空。必須先執行此操作才能進行其他操作。

用法：

drone.take_off(climb_to, units, wait)

參數	描述
climb_to	無人機將飛到的z軸位置。
units	單位： CM - 公分 MM - 毫米 INCHES
wait	可选。 wait=True（默认）- 无人机等待 take_off 完成后才执行下一行代码。 wait=False - 无人机启动该动作后立即继续执行下一行代码，而不等待 take_off 完成。

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()