Python#

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

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

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

VEXcode VR 中的 Python 指令可能取決於您使用的 Playground 和機器人。某些機器人包含一些獨特的、並非所有 Playground 都提供的方法。

虛擬實境中的遊樂場與機器人#

使用 Playgrounds 部分查看每個 Playground 中使用的機器人，並尋找 Playground 特定的設定詳情、場地資訊和挑戰背景。

使用 Robots 部分尋找具有獨特方法的機器人的 Python 頁面。機器人頁面還會顯示每個機器人在哪些 Playground 中使用，以便您了解專案中何時可以使用機器人特有的方法。

如何閱讀方法條目#

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

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

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

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

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

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

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

常用 Python API 元素#

元素

它的意義

方法

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

功能

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

範圍

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

可選參數

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

傳回值

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

Python基礎詞彙#

學期

它的意義

多變的

儲存值的名稱，例如 angle = 90。

細繩

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

整數

正數或負數，例如 90。

漂浮

帶小數的數字，例如 25.5。

布林值

值為 True （假）或 False假）。

爭論

傳遞給方法或函數呼叫的值，例如 DEGREES in drivetrain.rotation(DEGREES)。

範例方法輸入#

旋轉#

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. rotation returns the robot’s current rotation.

向右轉會增加旋轉角度，向左轉會減少旋轉角度。例如，向右轉兩圈將得到 720 度的旋轉角度。

Usage:
drivetrain.rotation(units)

參數

描述

units

可選。旋轉單位： DEGREES （預設值）。

 
def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)
On this page