Python#

VEXcode VR Python API-referensen förklarar vad varje kommando, metod och funktion gör, vilka indata den använder, vad den returnerar och hur den kan användas i ett projekt.

Använd den här referensen när du vill förstå ett kommando innan du lägger till det i ett projekt, kontrollera vilka värden det accepterar eller returnerar, eller jämföra relaterade kommandon i en kategori.

Python-kommandon används i VEXcode VR Python-projekt. Blocks-projekt använder istället Blocks API-sektionen.

Python-kommandon i VEXcode VR kan bero på vilken Playground och robot du använder. Vissa robotar inkluderar unika metoder som inte visas i varje Playground.

Lekplatser och robotar i VR#

Använd avsnittet Lekplatser för att se vilken robot som används i varje lekplats och för att hitta lekplatsspecifika installationsdetaljer, fältinformation och utmaningskontext.

Använd avsnittet Robotar för att hitta robotspecifika Python-sidor för robotar med unika metoder. Robotsidorna visar också vilka Playgrounds varje robot används i, så att du kan se när en robotspecifik metod är tillgänglig i ditt projekt.

Hur man läser en metodpost#

De flesta Python-poster innehåller följande delar:

  • Kommandonamn - Det officiella namnet på kommandot, metoden eller funktionen.

  • Beskrivning - Förklarar vad kommandot gör och när det är användbart.

  • Användning - Visar syntaxen som används för att skriva kommandot i kod.

  • Parametrar - Listar de indata som kommandot accepterar och förklarar vad var och en gör.

  • Returvärde - Förklarar vad kommandot rapporterar tillbaka om det returnerar ett värde.

  • Exempelkod - Visar ett sätt som kommandot kan användas i ett projekt.

Vanliga Python API-element#

Element

Vad det betyder

Metod

Ett kommando som anropas på ett objekt som drivetrain.rotation(…).

Fungera

Ett kommando som anropas direkt, såsom wait(…) eller print(…).

Parameter

Ett värde som matas in i en metod eller funktion för att styra vad den gör.

Valfri parameter

En parameter som kan utelämnas så att standardbeteendet används.

Returvärde

Ett värde som ett kommando rapporterar tillbaka, till exempel ett tal, en text eller ett booleskt värde.

Grundläggande Python-vokabulär#

Kalla

Vad det betyder

Variabel

Ett namn som lagrar ett värde, till exempel angle = 90.

Sträng

Text inom citattecken, till exempel “Hello”.

Heltal

Ett positivt eller negativt tal, till exempel 90

Flyta

Ett tal med ett decimaltal, till exempel 25.5.

Boolesk

Ett värde som antingen är True eller False.

Argument

Ett värde som matas in i ett metod- eller funktionsanrop, till exempel DEGREES i drivetrain.rotation(DEGREES).

Exempel på metodinmatning#

rotation#

Rotation är hur mycket roboten har roterat, mätt i grader. I början av ett projekt sätts rotationsvärdet till 0 grader. rotation returnerar robotens aktuella rotation.

Att vrida åt höger ökar rotationen, och att vrida åt vänster minskar rotationen. Om du till exempel gör två hela varv åt höger får du en rotation på 720 grader.

Usage:
drivetrain.rotation(units)

Parametrar

Beskrivning

units

Valfritt. Rotationsenheten: DEGREES (standard).

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)