Python#

Referenční příručka k Python API pro VEX AIR vysvětluje, co každý příkaz, metoda a funkce dělá, jaké vstupy používá, co vrací a jak ji lze použít v projektu.

Tuto referenci použijte, pokud chcete porozumět příkazu před jeho přidáním do projektu, zkontrolovat, jaké hodnoty přijímá nebo vrací, nebo porovnat související příkazy v kategorii.

Příkazy Pythonu se používají v projektech VEXcode AIR Python. Projekty Blocks místo toho používají sekci Blocks API.

Jak číst záznam metody#

Většina položek v Pythonu obsahuje následující části:

  • Název příkazu – Oficiální název příkazu, metody nebo funkce.

  • Popis – Vysvětluje, co příkaz dělá a kdy je užitečný.

  • Použití – Zobrazuje syntaxi použitou k zápisu příkazu v kódu.

  • Parametry – Vypíše vstupy, které příkaz akceptuje, a vysvětlí, co každý z nich dělá.

  • Návratová hodnota – Vysvětluje, co příkaz hlásí zpět, pokud vrací hodnotu.

  • Příklad kódu – Ukazuje jeden způsob použití příkazu v projektu.

Běžné prvky Python API#

Živel

Co to znamená

Metoda

Příkaz volaný na objektu, například drone.take_off(…).

Funkce

Příkaz volaný přímo, například wait(…) nebo print(…).

Parametr

Hodnota předávaná metodě nebo funkci za účelem řízení její činnosti.

Volitelný parametr

Parametr, který lze vynechat, aby se použilo výchozí chování.

Návratová hodnota

Hodnota, kterou příkaz hlásí zpět, například číslo, text nebo booleovská hodnota.

Základní slovní zásoba Pythonu#

Období

Co to znamená

Proměnná

Název, který ukládá hodnotu, například height = 500.

Řetězec

Text v uvozovkách, například “Hello”.

Celé číslo

Kladné nebo záporné číslo, například 90.

Plovák

Číslo s desetinnou čárkou, například 25.5.

Boolean

Hodnota, která je buď True nebo False.

Argument

Hodnota předaná volání metody nebo funkce, například 500 z drone.take_off(climb_to=500).

Příklad zadání metody#

vzlet#

take_off spustí vrtule a zvedne dron do vzduchu. Tuto metodu je nutné použít před provedením dalších pohybů.

Používání:

drone.take_off(climb_to, units, wait)

Parametry

Popis

climb_to

Pozice Z, do které dron poletí.

units

Použité jednotky:

  • CM - Centimetry
  • MM - Milimetry
  • INCHES

wait

Volitelné.

  • wait=True (výchozí) - Dron čeká na dokončení take_off před provedením dalšího řádku kódu.
  • wait=False - Dron zahájí akci a ihned přejde na další řádek kódu, aniž by čekal na dokončení take_off

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