Python#

W dokumencie VEXcode VR 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 VEXcode VR Python. Projekty bloków korzystają z sekcji API bloków.

Polecenia Pythona w VEXcode VR mogą zależeć od używanego placu zabaw i robota. Niektóre roboty zawierają unikalne metody, które nie występują w każdym placu zabaw.

Place zabaw i roboty w VR#

W sekcji Place zabaw można sprawdzić, jaki robot jest używany na danym placu zabaw, a także znaleźć szczegóły dotyczące konfiguracji danego placu zabaw, informacje o polu i kontekst wyzwania.

W sekcji Roboty znajdziesz strony Pythona poświęcone robotom z unikalnymi metodami. Strony Roboty pokazują również, na których placach zabaw używany jest dany robot, dzięki czemu możesz sprawdzić, czy w Twoim projekcie dostępna jest metoda specyficzna dla danego robota.

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ływane na obiekcie takim jak drivetrain.rotation(…).

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

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, np. DEGREES in drivetrain.rotation(DEGREES).

Przykładowy wpis metody#

obrót#

Obrót to wartość obrotu robota, mierzona w stopniach. Na początku projektu wartość obrotu jest ustawiona na 0 stopni. rotation zwraca aktualny obrót robota.

Skręt w prawo zwiększa obrót, a skręt w lewo zmniejsza. Na przykład, wykonanie dwóch pełnych obrotów w prawo spowoduje obrót o 720 stopni.

Usage:
drivetrain.rotation(units)

Parametry

Opis

units

Opcjonalnie. Jednostka obrotu: DEGREES (domyślnie).

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)