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 |
Fungera |
Ett kommando som anropas direkt, såsom |
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 |
Sträng |
Text inom citattecken, till exempel |
Heltal |
Ett positivt eller negativt tal, till exempel |
Flyta |
Ett tal med ett decimaltal, till exempel |
Boolesk |
Ett värde som antingen är |
Argument |
Ett värde som matas in i ett metod- eller funktionsanrop, till exempel |
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 |
|---|---|
|
Valfritt. Rotationsenheten: |
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)