Python#

A VEXcode VR 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 VR Python projektekben Python parancsokat használnak. A Blocks projektek helyett a Blocks API részt használják.

A VEXcode VR Python parancsai a használt Playgroundtól és robottól függhetnek. Egyes robotok egyedi metódusokat tartalmaznak, amelyek nem minden Playgroundban jelennek meg.

Játszóterek és robotok VR-ban#

A Játszóterek részben megtekintheted, hogy melyik robotot használják az egyes játszótereken, valamint megtalálhatod a játszótérre jellemző beállításokat, a pályainformációkat és a kihívás kontextusát.

A Robotok részben robotspecifikus Python oldalakat találhatsz egyedi metódusokkal rendelkező robotokhoz. A Robotok oldalak azt is megmutatják, hogy az egyes robotok mely játszótereken használatosak, így láthatod, hogy mikor érhető el egy robotspecifikus metódus a projektedben.

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 parancs, amelyet egy objektumon hívtak meg, például drivetrain.rotation(…).

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 angle = 90.

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 DEGREES in drivetrain.rotation(DEGREES).

Példa metódusbevitelre#

forgás#

A forgás a robot elfordulásának mértékét adja meg fokban mérve. A projekt elején a forgás értéke 0 fok. rotation értéket adja vissza a robot aktuális forgását.

Jobbra fordulás növeli, balra fordulás pedig csökkenti az elfordulást. Például két teljes jobbra fordulás 720 fokos elfordulást eredményez.

Usage:
drivetrain.rotation(units)

Paraméterek

Leírás

units

Opcionális. Az elforgatás mértékegysége: DEGREES (alapértelmezett).

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)