Python

Die VEX AIR Python API-Referenz erklärt, was jeder Befehl, jede Methode und jede Funktion bewirkt, welche Eingaben sie benötigt, was sie zurückgibt und wie sie in einem Projekt verwendet werden kann.

Nutzen Sie diese Referenz, wenn Sie einen Befehl verstehen möchten, bevor Sie ihn einem Projekt hinzufügen, überprüfen möchten, welche Werte er akzeptiert oder zurückgibt, oder wenn Sie verwandte Befehle in einer Kategorie vergleichen möchten.

In VEXcode AIR Python-Projekten werden Python-Befehle verwendet. Blocks-Projekte nutzen stattdessen den Abschnitt der Blocks-API.

Wie man einen Methodeneintrag liest

Die meisten Python-Einträge enthalten die folgenden Bestandteile:

• Befehlsname - Der offizielle Name des Befehls, der Methode oder der Funktion.

• Beschreibung - Erklärt, was der Befehl bewirkt und wann er nützlich ist.

• Verwendung - Zeigt die Syntax, die zum Schreiben des Befehls im Code verwendet wird.

• Parameter - Listet die Eingaben auf, die der Befehl akzeptiert, und erklärt, was jede einzelne bewirkt.

• Rückgabewert - Erklärt, was der Befehl zurückgibt, falls er einen Wert zurückgibt.

• Beispielcode - Zeigt eine Möglichkeit, wie der Befehl in einem Projekt verwendet werden kann.

Gemeinsame Python-API-Elemente

Element	Was es bedeutet
Verfahren	Ein Befehl, der auf einem Objekt aufgerufen wird, wie z. B. drone.take_off(…).
Funktion	Ein direkt aufgerufener Befehl, wie z. B. wait(…) oder print(…).
Parameter	Ein Wert, der an eine Methode oder Funktion übergeben wird, um deren Verhalten zu steuern.
Optionaler Parameter	Ein Parameter, der weggelassen werden kann, sodass das Standardverhalten verwendet wird.
Rückgabewert	Ein Wert, den ein Befehl zurückgibt, z. B. eine Zahl, ein Text oder ein boolescher Wert.

Grundlegendes Python-Vokabular

Begriff	Was es bedeutet
Variable	Ein Name, der einen Wert speichert, z. B. height = 500.
String	Text innerhalb von Anführungszeichen, wie z. B. “Hello”.
Ganze Zahl	Eine positive oder negative Zahl, z. B. 90.
Schweben	Eine Zahl mit Dezimalstellen, wie zum Beispiel 25.5.
Boolesch	Ein Wert, der entweder True False ist.
Argument	Ein Wert, der an einen Methoden- oder Funktionsaufruf übergeben wird, z. B. 500 in drone.take_off(climb_to=500).

Beispiel für Methodeneingabe

abheben

take_off startet die Propeller und hebt die Drohne in die Luft. Diese Methode muss vor allen anderen Bewegungen angewendet werden.

Verwendung:

drone.take_off(climb_to, units, wait)

Parameter	Beschreibung
climb_to	Die z-Position, zu der die Drohne fliegen wird.
units	Die zu verwendende Einheit: CM - Zentimeter MM - Millimeter INCHES
wait	Optional. wait=True (Standard) – Die Drohne wartet, bis take_off abgeschlossen ist, bevor die nächste Codezeile ausgeführt wird. wait=False – Die Drohne startet die Aktion und fährt sofort mit der nächsten Codezeile fort, ohne auf take_off zu warten.

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