Python#

Referenční příručka VEXcode VR 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 VR Python. Projekty Blocks místo toho používají sekci Blocks API.

Příkazy Pythonu ve VEXcode VR mohou záviset na použitém Playgroundu a robotovi. Někteří roboti obsahují unikátní metody, které se neobjevují v každém Playgroundu.

Hřiště a roboti ve VR#

V sekci Hřiště najdete, který robot se používá na každém hřišti, a podrobnosti o nastavení, informace o hřišti a kontext výzev specifické pro dané hřiště.

V sekci Robots najdete stránky Pythonu specifické pro roboty s unikátními metodami. Stránky Robots také ukazují, ve kterých Playgroundech se daný robot používá, takže poznáte, kdy je ve vašem projektu k dispozici metoda specifická pro robota.

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

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

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

Příklad zadání metody#

otáčení#

Rotace udává, o kolik se robot otočil, měřeno ve stupních. Na začátku projektu je hodnota rotace nastavena na 0 stupňů. rotation vrací aktuální rotaci robota.

Otočení doprava zvětšuje rotaci a otočení doleva ji snižuje. Například provedení dvou celých otoček doprava vrátí rotaci o 720 stupňů.

Usage:
drivetrain.rotation(units)

Parametry

Popis

units

Volitelné. Jednotka rotace: DEGREES (výchozí).

 
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)
On this page