Python#

„VEXcode VR Python API“ nuorodoje paaiškinama, ką daro kiekviena komanda, metodas ir funkcija, kokias įvestis jie naudoja, ką grąžina ir kaip juos galima naudoti projekte.

Šią nuorodą naudokite, kai norite suprasti komandą prieš ją įtraukdami į projektą, patikrinti, kokias reikšmes ji priima arba grąžina, arba palyginti susijusias komandas kategorijoje.

„VEXcode VR Python“ projektuose naudojamos „Python“ komandos. „Blocks“ projektuose vietoj jų naudojama „Blocks“ API skiltis.

„Python“ komandos „VEXcode VR“ gali priklausyti nuo „Playground“ ir naudojamo roboto. Kai kurie robotai turi unikalius metodus, kurie nepasirodo kiekvienoje „Playground“ platformoje.

Žaidimų aikštelės ir robotai VR erdvėje#

Norėdami pamatyti, kuris robotas naudojamas kiekvienoje žaidimų aikštelėje, ir rasti konkrečią žaidimų aikštelei būdingą įrengimo informaciją, informaciją apie aikštelę ir iššūkio kontekstą, naudokite skyrių Žaidimų aikštelės.

Norėdami rasti robotams skirtus Python puslapius su unikaliais metodais, naudokite skyrių Robotai. Robotų puslapiuose taip pat rodoma, kuriose žaidimų aikštelėse naudojamas kiekvienas robotas, todėl galite sužinoti, kada jūsų projekte yra prieinamas robotui skirtas metodas.

Kaip skaityti metodo įrašą#

Daugumą „Python“ įrašų sudaro šios dalys:

  • Komandos pavadinimas – oficialus komandos, metodo arba funkcijos pavadinimas.

  • Aprašymas – Paaiškina, ką komanda daro ir kada ji naudinga.

  • Naudojimas – rodo sintaksę, naudojamą komandai rašyti kode.

  • Parametrai – Pateikia komandos priimamų įvesčių sąrašą ir paaiškina kiekvienos iš jų funkciją.

  • Grąžina reikšmę – Paaiškina, ką komanda praneša, jei grąžina reikšmę.

  • Pavyzdinis kodas – parodo vieną iš būdų, kaip komanda gali būti naudojama projekte.

Įprasti Python API elementai#

Elementas

Ką tai reiškia

Metodas

Komanda, iškviesta objektui, pvz., drivetrain.rotation(…).

Funkcija

Tiesiogiai iškviečiama komanda, pvz. wait(…) arba print(…).

Parametras

Reikšmė, perduodama metodui arba funkcijai, siekiant valdyti jo veiksmus.

Pasirinktinis parametras

Parametras, kurio galima praleisti, kad būtų naudojamas numatytasis veikimas.

Grąžinimo vertė

Komandos pateikiama reikšmė, pvz., skaičius, tekstas arba loginė reikšmė.

Pagrindinis Python žodynas#

Terminas

Ką tai reiškia

Kintamasis

Pavadinimas, kuriame saugoma reikšmė, pvz., angle = 90.

Eilutė

Tekstas kabutėse, pvz., “Hello”.

Sveikasis skaičius

Teigiamas arba neigiamas skaičius, pvz. 90.

Plūduriuojantis

Skaičius su dešimtainiu tikslumu, pvz., 25.5.

Būlio

Reikšmė, kuri yra True arba False.

Argumentas

Reikšmė, perduota metodo arba funkcijos iškvietimui, pvz., DEGREES iš drivetrain.rotation(DEGREES).

Metodo įvedimo pavyzdys#

rotacija#

Sukimas rodo, kiek robotas pasisuko, matuojamas laipsniais. Projekto pradžioje sukimosi vertė nustatoma į 0 laipsnių. rotation grąžina dabartinį roboto sukimąsi.

Sukant į dešinę, sukimasis padidėja, o sukant į kairę – sumažėja. Pavyzdžiui, padarius du pilnus posūkius į dešinę, sukimasis bus 720 laipsnių.

Usage:
drivetrain.rotation(units)

Parametrai

Aprašymas

units

Pasirinktinai. Pasukimo vienetas: DEGREES (numatytasis).

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)