Python#

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

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

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

如何閱讀方法條目#

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

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

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

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

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

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

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

常用 Python API 元素#

元素

它的意義

方法

對物件呼叫的命令,例如 robot.move_at(…)。

功能

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

範圍

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

可選參數

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

傳回值

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

Python基礎詞彙#

學期

它的意義

多變的

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

細繩

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

整數

正數或負數,例如 90。

漂浮

帶小數的數字,例如 25.5。

布林值

值為 True (假)或 False假)。

爭論

傳遞給方法或函數呼叫的值,例如 0 在 robot.move_at(0)。

範例方法輸入#

移動到#

move_at 會使機器人以特定角度持續移動。機器人將一直移動,直到收到其他指令,例如改變移動角度、轉彎或停止。

用法:
robot.move_at(angle, velocity, units)

參數

描述

angle

機器人移動的角度,以度為單位。該值可以是介於 -360 到 360 之間的整數或小數。

velocity

可选。移动速度:使用 PERCENT 时为 0% 到 100%,使用 MMPS 时为 0 到 200 毫米/秒。可以是整数或小数。如果未提供速度,机器人将以当前移动速度移动。

units

可選。速度單位: PERCENT (預設)或 MMPS (毫米每秒)。

# Move forward
robot.move_at(0)