Python

VEX AIR 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 AIR Python-projekt. Blocks-projekt använder istället Blocks API-sektionen.

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 drone.take_off(…).
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 height = 500.
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 500 i drone.take_off(climb_to=500).

Exempel på metodinmatning

start

take_off startar propellrarna och lyfter drönaren upp i luften. Denna metod måste användas innan andra rörelser kan göras.

Användande:

drone.take_off(climb_to, units, wait)

Parametrar	Beskrivning
climb_to	Z-positionen som drönaren kommer att flyga till.
units	Enheten att använda: CM - Centimeter MM - Millimeter INCHES
wait	Valfritt. wait=True (standard) - Drönaren väntar tills take_off är klar innan nästa kodrad körs. wait=False - Drönaren startar åtgärden och går vidare till nästa kodrad direkt, utan att vänta på att take_off ska vara klar.

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()