Python#

W dokumencie VEX V5 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 VEXcode V5. 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 `360.0` in `drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)`.

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 zostanie mu przydzielona inna czynność, taka jak obrót lub zatrzymanie. W przypadku obrotów na minutę (RPM) lub stopni na sekundę, limit jest zmieniany przez przełożenie układu napędowego.

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 600 obr./min przy użyciu opcji `RPM`lub od 0 do 3600 stopni na sekundę przy użyciu opcji `VelocityUnits.DPS`Moż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: `RPM` (obroty na minutę, domyślnie), `PERCENT`lub `VelocityUnits.DPS` (stopnie na sekundę).

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

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)