Python#

Referenční příručka VEX AIM Python API 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 AIM 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 `robot.move_at(…)`.
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 `speed = 50`.
Ř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 `0` v `robot.move_at(0)`.

Příklad zadání metody#

přesunout_na#

move_at pohybuje robotem navždy v určitém úhlu. Robot se bude pohybovat, dokud mu nebude přidělena jiná akce, jako je pohyb v jiném úhlu, otočení nebo zastavení.

Usage:
robot.move_at(angle, velocity, units)

Parametry	Popis
`angle`	Úhel ve stupních, o který se robot pohne. Může to být celé číslo nebo desetinné číslo od -360 do 360.
`velocity`	Volitelné. Rychlost pohybu od 0 % do 100 % při použití `PERCENT`nebo od 0 do 200 milimetrů za sekundu při použití `MMPS`Může se jednat o celé nebo desetinné číslo. Pokud není zadána žádná rychlost, robot se pohybuje aktuální rychlostí pohybu.
`units`	Volitelné. Jednotka rychlosti: `PERCENT` (výchozí) nebo `MMPS` (milimetry za sekundu).

# Move forward
robot.move_at(0)