Python#

VEX AIR Python API atsauce paskaidro, ko dara katra komanda, metode un funkcija, kādus ievades datus tā izmanto, ko atgriež un kā to var izmantot projektā.

Izmantojiet šo atsauci, ja vēlaties izprast komandu pirms tās pievienošanas projektam, pārbaudīt, kādas vērtības tā pieņem vai atgriež, vai salīdzināt saistītas komandas kategorijā.

Python komandas tiek izmantotas VEXcode AIR Python projektos. Blocks projektos tā vietā tiek izmantota Blocks API sadaļa.

Kā lasīt metodes ierakstu#

Lielākā daļa Python ierakstu ietver šādas daļas:

  • Komandas nosaukums — komandas, metodes vai funkcijas oficiālais nosaukums.

  • Apraksts — Paskaidro, ko komanda dara un kad tā ir noderīga.

  • Lietojums — Parāda sintaksi, kas izmantota komandas rakstīšanai kodā.

  • Parametri — Uzskaita ievades datus, ko komanda pieņem, un paskaidro, ko katrs no tiem dara.

  • Atgrieztā vērtība — Paskaidro, ko komanda ziņo, ja tā atgriež vērtību.

  • Koda piemērs — parāda vienu veidu, kā komandu var izmantot projektā.

Bieži sastopamie Python API elementi#

Elements

Ko tas nozīmē

Metode

Komanda, kas izsaukta objektam, piemēram, drone.take_off(…).

Funkcija

Tieši izsaukta komanda, piemēram wait(…) vai print(…).

Parametrs

Vērtība, kas nodota metodei vai funkcijai, lai kontrolētu tās darbību.

Neobligāts parametrs

Parametrs, ko var izlaist, lai tiktu izmantota noklusējuma darbība.

Atgriešanas vērtība

Vērtība, ko komanda ziņo atpakaļ, piemēram, skaitlis, teksts vai Būla vērtība.

Python pamata vārdu krājums#

Termiņš

Ko tas nozīmē

Mainīgais

Nosaukums, kurā tiek glabāta vērtība, piemēram, height = 500.

Virkne

Teksts pēdiņās, piemēram “Hello”.

Vesels skaitlis

Pozitīvs vai negatīvs skaitlis, piemēram 90.

Peldošs

Skaitlis ar decimālzīmi, piemēram, 25.5.

Būla

Vērtība, kas ir vai nu True , vai False.

Arguments

Vērtība, kas nodota metodes vai funkcijas izsaukumam, piemēram, 500 in drone.take_off(climb_to=500).

Metodes ievades piemērs#

pacelšanās#

take_off iedarbina propellerus un paceļ dronu gaisā. Šī metode jāizmanto pirms citu kustību veikšanas.

Lietojums:

drone.take_off(climb_to, units, wait)

Parametri

Apraksts

climb_to

Z pozīcija, uz kuru drons lidos.

units

Lietojamā mērvienība:

  • CM - centimetri
  • MM - milimetri
  • INCHES

wait

Neobligāti.

  • wait=True (noklusējums) — Drons gaida, līdz take_off ir pabeigts, pirms tiek izpildīta nākamā koda rinda.
  • wait=False — Drons sāk darbību un nekavējoties pāriet uz nākamo koda rindu, negaidot take_off pabeigšanu.

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