Python#

W dokumencie VEX EXP 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 EXP Python. Bloki i projekty C++ korzystają z innych sekcji API.

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

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. speed = 50.

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 FORWARD in drivetrain.drive(FORWARD).

Przykładowy wpis metody#

prowadzić#

Napęd drive porusza robota do przodu lub do tyłu w nieskończoność. Robot będzie się poruszał, dopóki nie otrzyma innej akcji, takiej jak obrót lub zatrzymanie.

Usage:
drivetrain.drive(direction, velocity, units)

Parametry

Opis

direction

Kierunek, w którym porusza się robot: FORWARD lub REVERSE.

velocity

Opcjonalnie. Prędkość jazdy od 0% do 100% przy użyciu opcji PERCENT, od 0 do 120 obr./min przy użyciu opcji RPMlub od 0 do 720 stopni na sekundę przy użyciu opcji VelocityUnits.DPSMoże to być liczba całkowita integer lub dziesiętna (float). Jeśli prędkość nie zostanie podana, robot będzie jechał z bieżącą prędkością jazdy.

units

Opcjonalnie. Jednostka prędkości: PERCENT (domyślnie), RPM (obroty na minutę) lub VelocityUnits.DPS (stopnie na sekundę).

 
# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()


# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()
On this page