Python

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

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

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

如何閱讀方法條目

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

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

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

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

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

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

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

常用 Python API 元素

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

Python基礎詞彙

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

範例方法輸入

move_inc

move_inc 將 6 軸機械手臂沿著 x、y 和 z 軸移動指定的距離。

此方法將傳回布林值，指示六軸機械手臂是否已到達請求的位置：

• True - 6軸機械手臂已到達所要求的位置。

• False - 6軸機械手臂無法到達請求的位置。

Usage:
arm.move_inc(x, y, z, wait)

範圍	描述
x	沿 x 軸移動的距離（單位：毫米）。
是	沿 y 軸移動的距離（單位：毫米）。
z	沿 z 軸移動的距離，單位為毫米。
wait	Optional. wait=True (default) - The project waits until move_inc is complete before executing the next line of code. wait=False - The project starts the action and moves on to the next line of code right away, without waiting for move_inc to finish.

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)