Python#

VEXcode VR 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 VR Python -projekteissa. Blocks-projektit käyttävät sen sijaan Blocks API -osiota.

VEXcode VR:n Python-komennot voivat riippua käyttämästäsi Playgroundista ja robotista. Joillakin roboteilla on ainutlaatuisia metodeja, joita ei esiinny jokaisessa Playgroundissa.

Leikkikentät ja robotit VR:ssä#

Käytä Leikkikentät-osiota nähdäksesi, mitä robottia käytetään kullakin leikkikentällä, ja löytääksesi leikkikenttäkohtaisia ​​​​asetuksia, kenttätietoja ja haasteen kontekstin.

Käytä Robotit-osiota löytääksesi robottikohtaisia ​​Python-sivuja roboteille, joilla on ainutlaatuisia metodeja. Robotit-sivut näyttävät myös, millä leikkikentillä kutakin robottia käytetään, joten voit selvittää, milloin robottikohtainen metodi on käytettävissä projektissasi.

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

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

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

Esimerkki menetelmän syötteestä#

kierto#

Rotaatio ilmaisee robotin kääntymismäärän asteina. Projektin alussa rotaatioarvoksi asetetaan 0 astetta. rotation palauttaa robotin nykyisen rotaation.

Kääntyminen oikealle lisää kiertoliikettä ja kääntäminen vasemmalle vähentää sitä. Esimerkiksi kahden täyden käännöksen tekeminen oikealle palauttaa 720 asteen kiertoliikkeen.

Usage:
drivetrain.rotation(units)

Parametrit

Kuvaus

units

Valinnainen. Kiertoyksikkö: DEGREES (oletus).

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)