Python

A VEX AIR Python API referencia elmagyarázza az egyes parancsok, metódusok és függvények működését, a bemeneteket, a visszaadott értékeket és a projektben való felhasználásuk módját.

Ezt a referenciát akkor használd, ha egy parancsot meg szeretnél érteni, mielőtt hozzáadnád egy projekthez, ellenőrizni szeretnéd, hogy milyen értékeket fogad el vagy ad vissza, vagy összehasonlítani szeretnéd a kapcsolódó parancsokat egy kategóriában.

A VEXcode AIR Python projektekben Python parancsokat használnak. A Blocks projektek helyett a Blocks API részt használják.

Hogyan olvassunk el egy metódusbejegyzést

A legtöbb Python bejegyzés a következő részeket tartalmazza:

• Parancs neve – A parancs, metódus vagy függvény hivatalos neve.

• Leírás – Elmagyarázza, hogy mit csinál a parancs, és mikor hasznos.

• Használat – Megjeleníti a parancs kódban való írásához használt szintaxist.

• Paraméterek – Felsorolja a parancs által elfogadott bemeneteket, és elmagyarázza, hogy mit csinálnak.

• Visszatérési érték – Elmagyarázza, hogy mit jelent vissza a parancs, ha értéket ad vissza.

• Példakód – Bemutat egy módot, ahogyan a parancs használható egy projektben.

Gyakori Python API elemek

Elem	Mit jelent
Módszer	Egy objektumon meghívott parancs, például drone.take_off(…).
Funkció	Egy közvetlenül meghívott parancs, például wait(…) vagy print(…).
Paraméter	Egy metódusnak vagy függvénynek átadott érték, amely a műveletét szabályozza.
Választható paraméter	Egy paraméter, amelyet ki lehet hagyni, így az alapértelmezett viselkedés lesz érvényben.
Visszatérési érték	Egy parancs által visszaadott érték, például szám, szöveg vagy logikai érték.

Alapvető Python szókincs

Kifejezés	Mit jelent
Változó	Egy olyan név, amely értéket tárol, például height = 500.
Húr	Idézőjelek között lévő szöveg, például “Hello”.
Egész szám	Pozitív vagy negatív szám, például 90.
Úszó	Tizedesjegyet tartalmazó szám, például 25.5.
Logikai	Egy olyan érték, amely vagy True , vagy False.
Érv	Egy metódusnak vagy függvényhívásnak átadott érték, például 500 in drone.take_off(climb_to=500).

Példa metódusbevitelre

felszállás

take_off beindítja a propellereket és a levegőbe emeli a drónt. Ezt a módszert minden más mozgás végrehajtása előtt alkalmazni kell.

Használat:

drone.take_off(climb_to, units, wait)

Paraméterek	Leírás
climb_to	A drón z pozíciója, ahová repülni fog.
units	A használandó mértékegység: CM centiméter MM milliméter INCHES
wait	Opcionális. wait=True (alapértelmezett) - A drón megvárja, amíg take_off befejeződik, mielőtt végrehajtaná a következő kódsort. wait=False - A drón megkezdi a műveletet, és azonnal a következő kódsorra lép, anélkül, hogy megvárná take_off befejezését.

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