Python#

W dokumencie VEX AIR Python API Reference wyjaśniono, co robi każde polecenie, metoda i funkcja, jakich danych wejściowych używa, co zwraca i jak można je wykorzystać w projekcie.

Skorzystaj z tego odniesienia, jeśli chcesz zrozumieć polecenie przed dodaniem go do projektu, sprawdzić, jakie wartości akceptuje lub zwraca, lub porównać powiązane polecenia w danej kategorii.

Polecenia Pythona są używane w projektach Python w środowisku VEXcode AIR. Projekty bloków korzystają z sekcji API bloków.

Jak czytać wpis metody#

Większość wpisów dotyczących Pythona zawiera następujące części:

  • Nazwa polecenia – oficjalna nazwa polecenia, metody lub funkcji.

  • Opis – wyjaśnia, co robi polecenie i kiedy jest przydatne.

  • Użycie – Pokazuje składnię użytą do zapisania polecenia w kodzie.

  • Parametry – wypisuje akceptowane przez polecenie dane wejściowe i wyjaśnia, co każdy z nich robi.

  • Wartość zwracana – wyjaśnia, co polecenie zwraca, jeśli zwraca wartość.

  • Przykładowy kod – Pokazuje jeden sposób wykorzystania polecenia w projekcie.

Wspólne elementy API Pythona#

Element

Co to znaczy

Metoda

Polecenie wywołane na obiekcie takim jak drone.take_off(…).

Funkcjonować

Polecenie wywoływane bezpośrednio, takie jak wait(…) lub print(…).

Parametr

Wartość przekazywana do metody lub funkcji w celu kontrolowania jej działania.

Parametr opcjonalny

Parametr, który można pominąć, aby użyć domyślnego zachowania.

Wartość zwracana

Wartość zwracana przez polecenie, np. liczba, tekst lub wartość logiczna.

Podstawowe słownictwo Pythona#

Termin

Co to znaczy

Zmienny

Nazwa przechowująca wartość, np. height = 500.

Smyczkowy

Tekst w cudzysłowie, np. “Hello”.

Liczba całkowita

Liczba dodatnia lub ujemna, np. 90.

Platforma

Liczba z częścią dziesiętną, np. 25.5.

Boolean

Wartość, która wynosi True lub False.

Argument

Wartość przekazana do wywołania metody lub funkcji, taka jak 500 in drone.take_off(climb_to=500).

Przykładowy wpis metody#

startować#

take_off uruchamia śmigła i unosi drona w powietrze. Ta metoda musi zostać użyta przed wykonaniem innych ruchów.

Stosowanie:

drone.take_off(climb_to, units, wait)

Parametry

Opis

climb_to

Pozycja Z, do której poleci dron.

units

Jednostka miary:

  • CM - Centymetry
  • MM - Milimetry
  • INCHES

wait

Opcjonalnie.

  • wait=True (domyślnie) — Dron czeka, aż take_off zakończy się, zanim wykona następny wiersz kodu.
  • wait=False — Dron rozpoczyna akcję i od razu przechodzi do następnego wiersza kodu, nie czekając na zakończenie take_off

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