Python#

A VEX AIM 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 AIM 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 – Megadja, 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 robot.move_at(…).

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 speed = 50.

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ódus- vagy függvényhívásnak átadott érték, például 0 in robot.move_at(0).

Példa metódusbevitelre#

move_at#

move_at A robotot egy adott szögben, örökké mozgatja. A robot addig mozog, amíg egy másik műveletet nem kap, például más szögben mozog, megfordul vagy megáll.

Usage:
robot.move_at(angle, velocity, units)

Paraméterek

Leírás

angle

A robot mozgásának szöge fokban megadva. Ez lehet egész vagy tizedes tört -360 és 360 között.

velocity

Opcionális. A mozgási sebesség 0% és 100% között PERCENThasználata esetén, vagy 0 és 200 milliméter/másodperc között MMPShasználata esetén. Ez lehet egész vagy tizedes tört. Ha nincs megadva sebesség, a robot az aktuális mozgási sebességgel mozog.

units

Opcionális. A sebesség mértékegysége: PERCENT (alapértelmezett) vagy MMPS (milliméter másodpercenként).

# Move forward
robot.move_at(0)