Python#

VEX AIR Python API Reference selittää, mitä kukin komento, metodi ja funktio tekee, mitä syötteitä ne käyttävät, mitä ne palauttavat ja miten niitä voidaan käyttää projektissa.

Käytä tätä viitettä, kun haluat ymmärtää komennon ennen sen lisäämistä projektiin, tarkistaa sen hyväksymät tai palauttamat arvot tai vertailla toisiinsa liittyviä komentoja kategoriassa.

Python-komentoja käytetään VEXcode AIR Python -projekteissa. Blocks-projektit käyttävät sen sijaan Blocks API -osiota.

Metodimerkinnän lukeminen#

Useimmat Python-merkinnät sisältävät seuraavat osat:

  • Komennon nimi - Komennon, metodin tai funktion virallinen nimi.

  • Kuvaus - Selittää, mitä komento tekee ja milloin siitä on hyötyä.

  • Käyttö - Näyttää komennon kirjoittamiseen käytetyn syntaksin koodissa.

  • Parametrit - Listaa komennon hyväksymät syötteet ja selittää, mitä kukin niistä tekee.

  • Paluuarvo - Selittää, mitä komento raportoi, jos se palauttaa arvon.

  • Esimerkkikoodi - Näyttää yhden tavan, jolla komentoa voidaan käyttää projektissa.

Yleisiä Python API -elementtejä#

Elementti

Mitä se tarkoittaa

Menetelmä

Komento, jota kutsutaan objektille, kuten drone.take_off(…).

Toiminto

Suoraan kutsuttu komento, kuten wait(…) tai print(…).

Parametri

Metodille tai funktiolle välitetty arvo, joka ohjaa sen toimintaa.

Valinnainen parametri

Parametri, joka voidaan jättää pois, jolloin käytetään oletustoimintoa.

Palautusarvo

Komennon raportoima arvo, kuten numero, teksti tai totuusarvo.

Pythonin perussanasto#

Termi

Mitä se tarkoittaa

Muuttuja

Nimi, joka tallentaa arvon, kuten height = 500.

Merkkijono

Teksti lainausmerkkien sisällä, kuten “Hello”.

Kokonaisluku

Positiivinen tai negatiivinen luku, kuten 90.

Kellua

Desimaaliluku, kuten 25.5.

Totuusarvo

Arvo, joka on joko True tai False.

Argumentti

Metodiin tai funktiokutsuun välitetty arvo, kuten 500 in drone.take_off(climb_to=500).

Esimerkki menetelmän syötteestä#

lentoonlähtö#

take_off käynnistää potkurit ja nostaa dronin ilmaan. Tätä menetelmää on käytettävä ennen kuin muita liikkeitä voidaan tehdä.

Käyttö:

drone.take_off(climb_to, units, wait)

Parametrit

Kuvaus

climb_to

Z-asento, johon drone lentää.

units

Käytettävä yksikkö:

  • CM - senttimetriä
  • MM - millimetriä
  • INCHES

wait

Valinnainen.

  • wait=True (oletus) - Drooni odottaa, kunnes take_off on valmis, ennen seuraavan koodirivin suorittamista.
  • wait=False - Drooni aloittaa toiminnon ja siirtyy seuraavalle koodiriville heti odottamatta take_off valmistumista.

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