Python#

„VEX AIR 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 AIR Python“ projektuose naudojamos „Python“ komandos. „Blocks“ projektuose vietoj jų naudojama „Blocks“ API skiltis.

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., drone.take_off(…).

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., height = 500.

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., 500 in drone.take_off(climb_to=500).

Metodo įvedimo pavyzdys#

pakilimas#

take_off paleidžia sraigtus ir pakelia droną į orą. Šis metodas turi būti naudojamas prieš atliekant kitus judesius.

Naudojimas:

drone.take_off(climb_to, units, wait)

Parametrai

Aprašymas

climb_to

Z padėtis, į kurią dronas skris.

units

Naudojami vienetai:

  • CM - centimetrai
  • MM - milimetrai
  • INCHES

wait

Pasirinktinai.

  • wait=True (numatytasis) – dronas laukia, kol bus baigtas take_off prieš vykdydamas kitą kodo eilutę.
  • wait=False – dronas pradeda veiksmą ir iš karto pereina prie kitos kodo eilutės, nelaukdamas, kol take_off bus baigtas.

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