Python#

De VEX AIR Python API-referentie legt uit wat elk commando, elke methode en elke functie doet, welke invoerwaarden het gebruikt, wat het retourneert en hoe het in een project kan worden gebruikt.

Gebruik deze referentie wanneer u een commando wilt begrijpen voordat u het aan een project toevoegt, wilt controleren welke waarden het accepteert of retourneert, of verwante commando’s in een categorie wilt vergelijken.

In VEXcode AIR Python-projecten worden Python-opdrachten gebruikt. Blocks-projecten gebruiken in plaats daarvan de Blocks API-sectie.

Hoe lees je een methode-invoer?#

De meeste Python-inzendingen bevatten de volgende onderdelen:

  • Opdrachtnaam - De officiële naam van de opdracht, methode of functie.

  • Beschrijving - Legt uit wat het commando doet en wanneer het nuttig is.

  • Gebruik - Toont de syntaxis die gebruikt wordt om de opdracht in code te schrijven.

  • Parameters - Hier worden de invoerwaarden van het commando weergegeven en wordt uitgelegd wat elke waarde doet.

  • Retourwaarde - Legt uit wat de opdracht teruggeeft, indien deze een waarde retourneert.

  • Voorbeeldcode - Laat zien hoe de opdracht in een project gebruikt kan worden.

Veelgebruikte Python API-elementen#

Element

Wat het betekent

Methode

Een commando dat wordt aangeroepen op een object, zoals drone.take_off(…).

Functie

Een direct aangeroepen commando, zoals wait(…) of print(…).

Parameter

Een waarde die aan een methode of functie wordt doorgegeven om te bepalen wat deze doet.

Optionele parameter

Een parameter die weggelaten kan worden, zodat het standaardgedrag gebruikt wordt.

Retourwaarde

Een waarde die een commando teruggeeft, zoals een getal, tekst of Booleaanse waarde.

Basiswoordenschat van Python#

Termijn

Wat het betekent

Variabele

Een naam die een waarde opslaat, zoals height = 500.

Snaar

Tekst tussen aanhalingstekens, zoals “Hello”.

Geheel getal

Een positief of negatief getal, zoals 90.

Vlot

Een getal met een decimaal, zoals 25.5.

Booleaanse waarde

Een waarde die ofwel True of False is.

Argument

Een waarde die wordt doorgegeven aan een methode- of functieaanroep, zoals 500 in drone.take_off(climb_to=500).

Voorbeeld van methode-invoer#

start#

take_off start de propellers en tilt de drone de lucht in. Deze methode moet worden gebruikt voordat andere bewegingen kunnen worden uitgevoerd.

Gebruik:

drone.take_off(climb_to, units, wait)

Parameters

Beschrijving

climb_to

De z-positie waarnaar de drone zal vliegen.

units

De te gebruiken eenheid:

  • CM - Centimeters
  • MM - Millimeters
  • INCHES

wait

Optioneel.

  • wait=True (standaard) - De drone wacht tot take_off is voltooid voordat de volgende regel code wordt uitgevoerd.
  • wait=False - De drone start de actie en gaat direct door naar de volgende regel code, zonder te wachten tot take_off is voltooid.

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